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Visual Java Development 



Build Rome in a day. 

It's easy with Symantec 
Visual Cafer for Java: 


► 


Develop faster. Compile 
fester Debug fester Realize 
your Java'^ dreams fester 

Symantec, the creator of 
the first full-featured Java 
development environment, now unleashes 
the first Rapid Application Development 
environment for Java developers: 

Symantec Visual Cafei^ 



Visual Cafe comes complete with an 
extensible component library with all of the 
building blocks you need for your application. 


SimpV drag and drop a component 
onto a form. Our Interaction Wizard 
lets you visually specify all the actions 
and events. And then Visual Cafe 
automatically generates the Java 



¥ 

Thanks to our exclusive two-way 

$ 


programming you can add or modify 

'C C 

the code at the source level, too. 

Mac’OS 


So you'll be whipping out those 

[>Migntil tor 


application prototypes at speeds 



you can only dream of now. 

uicTpsefr 


Imagine building all of your forms 

Wlr*W95 


visually. Or building your entire user interface 
without writing one single line of codel 


As an added bonus. Symantec's Just In 
1 H me U IT) co mpile r Ci ncl uded in N etscape's 
new Navigator''^ runs your Java applications 
faster than any other browser or Java 
^ virtual machine on the planet 



Visual Cafe for Macintosh'and Windowsr 


So get your hands on the hottest new 
development tool for Java right away. 

For more information, caff us at 
1-800'453*1059 ext* 9H32 or visit our 
Web site at cafe.symantec.com. Or 
pick up a copy at your local reseller, 


SYMANTEC. 


Syinantec is a regfetsjreti iradecnerk arid Visual Cale h a trademari^ of Symantec Cortsoratton. Java ia a trademark erf Sun Minmayslems, Irtc. Mtcmaofl, Windows awj the Windows bgo are 
registered trademarks of Micg^ssofl Cofpoiatldn, Macintosh Is a leglgtaned trsderriafk and the tVlgcinlosh OS logo te a Uatfemark of ^ple Computer InC.. tiSed urMfet teehSs. Wotscape WgdpatOf 
I? a trademark of Netsc^^ Corporatiori. Ail other bmnd rvames at trademarks are property of their respective owners. ©1997 Symantec Corporatidr, All rights reseivfed. In Cirtada, call 
1-000.365-8641. In Ausstndla, call 02-9SS04aO0Jn Europe, coil 3^7T-^^ 














































*^ithout a doubiy the Premiere Resource Editor 
for the Mae OS ---A wealth of time-saving tools* 

“ MacUser Magazine Eddy Awards 

"A distinct improvement over Applets ResEdit 
- MacTeck Magazine 

'Every Mac OS developer should own a copy of Resorcerer ” 

— Leonard Rosenthal, Aladdin Systems 

''Without Resorcet'CTt our localization efforts would look like a 
Tower of BabeL Dont do product without itr 

- Greg Galanos, CEO and President, Metrowerks 

"ResorcerePs data template system is amazing” 

- Bill Goodman, author of Smaller Insialler and Compact Pro 


''Resorcerer Rocks! Huy it, you will NOT regret it” 

- Joe Zobkiw, author of A Fragment of Your Imagination 

''Resorcerer will pay for itself many times over in saved time and effort 

- MaclJser review 

"The template that disassembles 'PICTs is awesome! 

- Bill Steinberg, author ofPyro! and PETools 

"Resorcerer proved indispensihle in its own creation! 

— Doug McKenna, author of EA^sorcerer 





Version 2.0 


ORDERING INFO 


Requires System 7.0 or greater, 
1.5MB RAM, CD ROM 

Standard price: $256 (deciTnal) 
Wcb#jite price: $128 - $256 
{Educational, quantity, or 
other discounts available) 

Includes: Electronic documentation 
60-day Money*Back Guarantee 
Domestic standard shipping 

Payment: Check, PO'a, or Visa/MC 
Taxes: Colorado customers only 

Extras (call, fax, or email us): 

COD, FedEx, UPS Blue/Red, 
International Shipping 

Mathema:sthetics, inc. 

PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax: (303)440-0504 
re8orcerer@mathemacsthetics.com 


The Resource Editor for the Mac™ OS Wizard 


• Very fast, IlFS browser generically views any filers contents 

• Extensibility for new Resorcerer Apprentices (CFM plug-ins) 

• AppleScript Dictionary (‘aete’) Apprentice Editor 

• Integrated support for 'Mcmd^ menu commands 

• TextTVaits Editor 

• Complete ATFF sound Rie disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• HFS folder aitrihute editing 

• Temporary memory always used everywhere if needed 

• Automatically creates *STR#’s by parsing C/C++ source 


New 

in 

2 - 0 : 


Easier, faster, more Mac-like, and more productive than HesEdit 
Safer memory-based, not disk-file-based, design and operation 
All file information and common commands in one easy-to-use window 
Compares resource files, and even edits your data forks as well 
Visible, accumulating, editable scrap 

Searches and opens/marks/sclects resources by text content 
Makes global resource ID or type changes easily and safely 
Builds resource Hies from simple Rez-like scripts 
Most editors DoRez directly to the clipboard 

All graphic editors support screen-copying or partial screen-copying 
HoUlinkiiig Value Converter for editing 32 bits in a dozen formats 
Its own 32-bit List Mgr can open and edit very large data structures 
Templates can pre- and post-process any arbitrary data structure 
Includes nearly 200 templates for common system resources 
TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc. 
Full integrated support for editing color dialogs and menus 
IVy out balloons, *ictb"s, lists and popups, even create C source code 
Integrated single-window Ilex/Code Editor, with patching, searching 
Editors for cursors, versions, pictures, bundles, and lots more 
Relied on by thousands of Maci ntosh developers around the world 


lb order by erc^dit ciard, or to get the latest news, bug fixes, updates, and apprentices, visit our website.*. 

www.mathemaesthetics.com 
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REAjunry Distioktion FiiiIO.^Engage 

WWDC Ls over, and IVe just sj:^nr a full week listening to 
the ofBcia:! Apple message. Many weeks may have passed by the 
time you read this article, but my mind is still hashing out the 
things J heard just a few days ago. 

I must a<imit, 1 attended WWDC 1997 with pretty low 
expectations. Last year attendees had Copland forced on them as 
the only possible futuie for Macintosh development, lliis year was 
very diherent; Apple listened to developers and offered us several 
options for our fuiun.* development. In fad, they even encouraged 
us to send our comments to <rhapsody-dev-feedback@3pp!e.com>. I 
am pleased with how well Apple handled the conference. 

Rhapsody Does Not Make Obsolete Programmer's Abilities 

Since Apple and NeX'Cs merger, 1 have heard many 
Macintosh developers express amcern lhai iheir skills 
programming the MacinUxsli will lx: tjbsoleie. After all, Rliapsody 
replaces the Mac Toollx>x with soiiiething new, ctxle named 
Yellow Box. (Yellow Box is the combination of OPHNSf'EP anti 
key Apple technologies.) The APIs to Yellow Bt)x is dramatically 
different from the Macaotosh Tcxilbox. 

However, what makes a good programmer is not merely 
knowletlge of one system’s API Good progi'amming is about 
i)ringing organization to a c<>mj>lex situatkm, providing a simple 
solution to solve a complex problem, and identifying what a user 
wants. Our skills as programmers rely more heavily on our ability 
fo organize lire problem and stiliirion ihan they do on knowledge 
tjf any [^articular API. .Anyone can look u[^ API calls in a imnual, 
but it fakes an experienced programmer to ktiow what routines 
to look for anti how to connect them togeiher it) make a 
I nc-ii n ingf u 1 appi iea ti t)n. 

^^ome of our greatest skills as Madnlosli jirogiummers are our 
abilities to dc'sign meaningful interlaces to hcHp users .stilve t'omplex 
pix)[)lems. These skills can translate tt) any platlbrriu (One need try 
oitly a few Windows applications to .see how rare are these skilJ.s.) 
Even though we will need to learn a new progtamming 
environment, it also presents a fresh start for new and non- 
Macintosh i^rograiiinicrs to join us. Those who have die higli quality 
skills we have aime to expect of Madnttxsh Pixigrminei^ will do 
well; the others...well, who knows, Khaps<.xiy otTens many new 
opixjrtunities to build tnore itowcrrul and inieiesiing Uk)Is; 1 very 
much kx)k forward to using tliose look, and creating some myself. 

MacOS 8 IS Alive and Well 

A[>ple had many strong presentalioris al>out die future of 
MacOS 8. They presented a clear schedule for delivering 
significant upgrades well into 1999- They presented several new 
technologies lieing developed for MacOS 8. Most important, 
they told us Yellow Box w^ould be made to run on MacO^ 8 in 
addition to running on Rhapsody. 


Apple is realistic alxiut the addoption rate of Idiapsody; they 
expea 4r5 million l^hapsixly users by mid 1999. Tliat is a far cry 
from the currenl 27 million Mac'OS 7 users. Many developers have 
complained that they don't want to have to write tlieir applications 
twice: onc'e to support Rhapsody and a rewrite to support MacOS 
8. Apple has responded by ptirting die Yellow Box APIs to MacOS 
8, This will allow developers to use one API to write tlieir code 
once and have it run on all Mitdnrosh platforms. 

This single API approach is especially important given how 
much we all (developers and Apple) rely on MacOS 8 for our 
bread and butter now and for the future. Enabling developers to 
take avantage of Yellow Box to build applications faster than 
ever before and deploy them on MacOS 8 as well as Rhapsody 
makes it tliat much more compelling for us to begin our 
Rhapsody development as soon as possible. 

Elhapsody Provides Compelling New Opportunities 

Many Macintosh developers have l:»een dreaming for some 
time of entering the Windows software market. We see analisLs’ 
numbers that generally have an extra zero or two at the end as 
compared to our own Madntosii market. (People tend to forget 
that those extra zeros apply to costs as well as revenues, and to 
the number of competitors.) fve tidked with many developers 
struggling to deal with porting their software to other platfomis. 
Rhapstxly — or more specifically Yellow Box — offers a very 
diri’erent approach. Unlike Java, Yellow fkjx todiy offers a much 
more maiure Mjluiion to the multipkitfonn software problem. 
With so many competing implementations, Java only dreams of 
solving the pioblem of write yotir software once, and deploy it 
anywhere. Wiih Apple controlling all implementations, Yellow 
Box is actually delivering it. 

Apple has promLssed YeRow Box compatability in at least 
four flavors: Rhapsody for P()weiPC, Rhapsexiy for Intel, Yellow 
Box for MacOS, Yellow Box for Win32 (diat is, NT and 9x). 
Additionally, there are strong rumors that Yellow Box will also be 
available for StilaiLs and HP unix. Tltat is a pretty broad market. 
The goal is that we developers can write our software to one API 
and merely recompile for each target platform. Apple is even 
working on multiplatform delivery medianLsms. In reality there 
are subtle differences between platforms that recjuire some 
additioaiil tweaks, but Apple is helping even there. Por example, 
there is a s|x:cific nib file (resource fork) for each target platform, 
allowing platform-specific interftice changes tf> override the 
[>latfontfs deluLilt lx:haviDr. 

Anothei‘ reason to develop for Yellow Box is the 
completeness of the application framework. We have had 
framewtjrks for Macintosh for many years now, but none fully 
liidc tlie nexx! to know the underlying Mac Toollx>x. Yellow Box 
/Is the toollxjx. When building an Yellow Box application, so 

continued on page 59 
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MORE DEVELOPERS PROTECT. 



« //// . '^ W^ - 

MacHASP Packs 
More Into Less. 

Basal on sUile-or-llie art ASIC technology. 
MacHASP packs the industry's most 
advanced security, cuinjiatibility and 
flexibility into a cnmpiict and end-uscr- 
friendly dongle. 

Grow With Aladdin! 

Hie fastest gnwing company 
in the industry, witli over 4 
million keys sold to 20 
thou.sanddevclo|X‘ni 
worldwide, Aladdin is setting 
the standanl for software security today. 

NSTL Study Rates 
HASP No.1! 

A recent test conducted by the National 
Software Testing kalis', the world’s foremost 
indeixaident lali, compared the flagship PC 
prodiicLs of leading software protection 
vendois. 'Ilie result? HASP was rated the clear 
overall winner - tmd number one in all the 
major uimpaiison categories, l-or a full aipy 
of tlie NSn. report, contact your l<x:al 
HASP distributor. 




MacHASP 
PROTECTS 
MORE. 


Mac-os 

These days, more and more develo[)ers are choosing to protect their software against 
jiiracy. They're protecting more products, on more platforms, with better protection - 
and selling more <ls a result. 

And more of ihesr! developers are protecting with MacHASP. Why? 

Because MacHASP offers more security, more reliability and more 
features than any other product on the market. Only MacHASP offers 
capabilities sucli tis network support, anli-debuggingenveloiie 
protection, and secure remote activation and uixlating. 

MacHASP supports the most ttdvancal platforms, including all 
versions of MacOS and Power Mac - as well as AppleTalk 
networks. And because Aladdin is a licensed Ajiple Partner, 

MacHASP guarantees full, transparent compatibility 
with the AHB standard. 

To learn more about how you can prelect 
better - ami sell more - call now to onler 
your MitcllASP Develofier’s Kit. 



ftk* .iiavIHSV Mfl dfguff's ^ malfttfiK 
KJW nm/hi ftrpfidmjr 


1 - 800 - 223-4277 

w w w , a k s . c o m 


MorHi America Aladdin Knowledge Systems Inc. Tfir OT) ‘iATK Kax; 2i2 %4 5177, K noil: 

Inti Office Aladdin Knowledge Systems Ltd. Tpl: ■ ^17^ 1221 Ktift +97W57 S?) 6 , K 

Germany FAST Software Security AG TpF i 49 W Hy 42 21 -57, hix; +49 H9 4 ^; | 40 ^ .. .. ftifoUtfftKi-in-.tlt: 

United Kingdom Alatkiin Knowledge Systems UK Ltd. IH, +44 1755-6222^16, Fax: iM l75,V6222(iZ, K-iiiall; sabKft^aklii.tH] iik 

Japan Aladdin Japan Lid. 114 1 nlil 42ifMjO nyi. Kax: +HI 426450 71'>1, \i miiil: Mitcs(p'':tl3itklni.ai.|ip 

Benelux Aladdin SoftwarB Security Benelux B.V. TV!: +51 244419777. Fax: +51 E-iimif: 100526 l356{^niiniLi.'«jFvi: uum 


ALADDIN 


The Frofessional's Choice 


■ MHKHnrhssaCIK O?limHJbslr^OaitaOli3gsgE!il»&RlM*Wd«(9Gaa7rj^la CMHlikM^ l^ SystffiriD H 

Knq Nnkip (17 SMWW 01 f B IWr On 07 B K«ta DM A 0? ■ llnici SIS^ BNAjeaJivB (H 1^0116014 ■ Piinia a 

a OheuLi Ba btcracliw (Mi 4 lAO^EtJ a im 465 505/91 ■ Saith Mtica D ta iHcua Dl ( (HKI 4 /V 4 a SpiBUi F>C ttiiBaaK 03 a SwitzertiMl Q|aig Il 6 i a Ttwtn T«;s«i 0 ? S!i 5 Q 0 r 5 a TjeIuit UHmUMd OItt? 45705 ^ ■ Vu^itfe Am Q^l 0239 ^ 









GETTIMG 

STARTED 


h}> Dave Mark. ©1997, All Rights Reserved 


Getting to Know NEXTSTEP 



Uu yt>u jx:mL'm[x.T the very first time you 
.Silt down lit a Maciniosli? For me, it was 
almost a religious expcmencc. I instantly 
connected to the interface*, to the elegance 
of the Mac kjok-and-feel Rettently, I’ve had 
the opportunity to explore some of the 
other major operating systems out there, 
including, most retrenrly, NtXl^rhP, i must 
say I was Iwth siiq>rised and impressed. 

Why spend time with NEmTEP? As 
you know, Apple lx>ught NeXT! with die 
intention of [)asing their next OS, Idiapsocly, 
on the NEXTSTTJ* technology. By tlie time 
yoLi reail this, Apple slu)uld ha pulling die 
finisliing touches on a pntHiminaty^ release of 
Jdiapsody. Till dien, NEXTSTEP is the closest 
tiling I liave to Rhapsody, Also, 1 think it is 
wortliwhile exploring the tools of our new 
OS, to gc*! a sen,se of the logic Ixfhind some 
of the Idiapsody design decisioas, 

NEXTSTEP is lx)th nic’e kxrking and 
easy to use. Though I did have trouble 
installing the develofXT’s release on my PC, 
once it was up and running I found 
NEXTS^PEP to lx solid ami a joy ro use, Ihis 
month, we'll take a first kx)k at NTOTTNTEP 
anti the process of building a console 
Ohjecnive-C app. Well also lcx>k at Objective- 
C's category mechanism, a cool way of 
seamk*ssly extending an existing cla,ss. 

'Phis month's column owes a debt of 
graiitude to CodeWarrior Gene Backiin. 
Gene wrote the book Developing 
NEX'PS'PEP Application,s (ISBN^ 06723- 
06381) and helped me come up to speed 
on the NEXI’STEP interfile and the 
Project Builder and Interface Builder 
applications. Tlianks, Gene! 

And thanks also to Michael Rutimn 
for his monthly expen tech review. As 
always, the mistakes are all mine... 


Working wnii NEXTSTEP 

One t)f tile first things yoxtll notice when you booi uj) under 
NEX'iyiTP is the ‘‘dtxk" lliai appears in the upi^r-right corner of 
your sixeen. My doc'k is 5lK)wn in Figure 1. Eac h sc|uare in the 
doc rcfiresents an NHXTS'l'HP application. The NeXT cube at the 
top of the doc represenLs the NEXTSTEP equivalent of the Finder, 
t';illed the EileViewen Below' that is the preferences application 
(wliicli I Ve set to show the time and date). Tlie IllsI three squares 
are a terminal emulator which you can use to run your console 
apps, and the two (>rognifas which make up the NEXTSTEP 
development environment, Project Builder (tire hammer) and 
Interface Builder (the screwdriver). We'll use the terminal 
emulator to build this mom IPs apps, and move on to Project 
Builder and Interface Builder next memth. 



Figure L The NFXlSTHl^ "'dock”. By defaull, il apjMfurs in the 
up}}er right corner of the NiXiyiFF screen. 

To launch an app from the dock, double-c'lick on its square. 
If the app is already nmning, a double-click will bring it to the 
foreground, just like a Mac. You can tell tf an app is not running 
by the elipsis (...) in die lower right corner of its dock square 
(t.e,, no ellipsis means the app is running). 
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WITHOUT US THEY 
W0ULDH T EXIST 
<OR HT LEHST TEET H 
BE MUCH MORE 
FRUSTRATEDa 

America Online 
Apple Computei 

Biederbund Software 

Canon 

Claiis 

CompuServe 

Batawore 

DipHal Equipment 
Fujitsu 

GE lnfotmatlon Systems 

ichat 


Maciomeilia 


National Geographic 


Now Software 


GONSIDER the possibilities. They’re 
wide open. Simply put, OpenPaige^ can 
do anything you want to the text of your 
software application. 

Across platforms, across aichitectures, 
even UNIX % OpenPaige is a feature-rich 
text environment. Every aspect of text and 
layout formatting, editing and display is 
possible. Stylized text. Scaling. Container 
and non-reclangular shapes. Style sheet 
support. Cut, copy and paste. Embedded 
pictures, objects, buttons and even calls to 
other applications are at your fingertips. 

Don’t waste time struggling with your 
text. We’ve already done the work for you. 
Drop in OpenPaige and go. Use as much or 


QuaiCotnm 

as little of it as you wish. Available as Seagate Software 

object code or as source code, it has 

an elegantly small footprint. Tet it will 

empower you to open doors, boundaries, 

and minds with your software application. 

But don’t take our word for it. Check us Wesi 
out our extensive and diverse client list. 

They’ve all discovered how the robust and 
flexible power of OpenPaige can open up 
entire new worlds of possibilities. 


Opm, „ 

• Paige 


Datapak 


Fbr addStiouai informaticn, ebe^ out oiu web site at www.datapak.com/'-to or caU us al 


CDEivnslit 1^1997 Ditlat»ak Sottwara. falga and OpanPaJga ara tiidarnarfcs ol Dalapak Sotiwara, All brand or product namoj art tradtmarka or reglsierad irademarkE of (hair respecllve holders. 

Datapak Software 11B1S NE laih Slroat, Suite 1200, VancoMvar, WA iSSS2 * Phona: 300,891,0542 • Fax: 380 J91.0743 * E-maM: salaa#ilalapak.ooni 




In i'cncnil ynu'lt use the File Viewer to wander around your 
h;ird drive, As you can .see in Figure 2, the Kile Viewer window 
is divided into three areas. "IlTe lop area is for rnounled volumes 
and aliases. The central strip shows where you arc oiirendy. In 
this case, we are l<K>king at the directory /myhost/me. The Ixjctom 
area shows the files and folders in llie current directory. In this 
case, llie directory /myhost/me contains 4 folders and 0 files. 



Fif^ttre 2, 'fhe File Viewer window, showini^ ihe yi/es m ibe 
default, "me" directory. 

Notice the apple icon in the floppy disk in die top line? Yup. 
I stuck a Mat: floppy in the VC floppy drive and NFXTSTEF 
recognised it. Very ctx>l! Tliat’s how 1 was able to get my source 
ccxle nnd screen shots (shot with the Grab applitiiiitm) over to 
my Mac. There’s something nice alx>tit lx4ng able to work widi 
a Mac floppy on my PC.., 

Figure i shows a pair of menu windows. Tlie left windt>w 
(labeled Workspace) holds the main File Viewer menu. The right 
window (labeled View) appeared when 1 clicked on the View 
item in the Workspace menu. Menus and submenu.s. Like a Mac, 
but different. Menu items can have conimand-key equivalents, 
Ixji since tfiis version of NEXTS'LEP was ninning on my PC. they 
were Alt key et|uivalents. In general NEX*I>>TEF feels like it 
Ix^rrowed heavily from tlie Mac (and why not?). If you are not 
sure how to do something, think alx>ut how you’d do il on a 
Mac. For example, Alt-c and Alf-v copy and paste, Ait-C[ i|uiLs, 
and Alt-w closes the frtmlmosi window. Sound familiar? 




[view 1 

i Into 


0rgurt«r ~ ' T IS 

1 File r-1 

Jean « . «H ’ 

lEdit 

3 

usimg lliZl 

! Disk r 1 

SafWwin* •* * 

View 

3 


1 ToilU T-1 

lyiew Vfe^f ^ 

Window? 

r 

UpdaleV^ii 

Se/vfees 

1 


Hitie- 

A 


! Log. Out 




Fij^ure JL 7he Works/Mice menu and View- submenu. 

NliX'I’S'fEP allows you to remap the keyboard. By default, 
on an Intel lx>x, the left Alt-Key Is mapjK'd to Ixj a tximmand 
key. Tfiere are sevend different configurations built in. and 
you can create your own. 


Figure 4 shows the lale Viewer with the Brow.ser View' 
selected, Tlie NeXT browser is a truly nice way to navig^ite your 
file system, I ho|X' diis pM of the NEXTS'LEF interface makes it 
into Rhapsixly, Note that as you de,scc'nd into a directory, the 
IKiih is reflected in the middle strip, while the details at eacli level 
are dLsplayed in the bnjw.ser portion at the ix>Rom of the File 
Viewer window. In Figure 4, we are It Hiking at the shapes 
directory, whic:h holds the files from last month’s Siimple f)rogram. 



Figure 4 , The File Vieufer, with the Browser eme. 

Ronnini; Last Month’s Exampi.e 

As I brought my source code over from my Mac (where I 
was nmning QxleBiJiklerX 1 learned a few hnportaoi lessons. 
First, try to avoid spaces in your file names. If you include a 
space in a file or directory name, you1l CTeate a lot of extra work 
(and potential hair pulling) for yourself as you ackl esc^apecl 
c|uotes to your makefiles, etc, to make sure die spaces arc kept 
in the names. Save yourself the trouble and leave the spaces out. 

Pm not sure of the details, but IVe found that some odd 
(invisible) characters creep into my code w'hcn porting from Mac 
to NEXTSTEP, This t:ould be a result of caniage retum/lioc feeds 
l>eing treated diHerendy on the two plattbnn,s, or an aitifact 
caused by my method of porting the files across. Regardless, if 
you find a line of ctxle that kx>ks ]XTfect, yet l>c!iaves txldfy, 
make sure dial your files are rate Unix files. If you create dicm 
in CotleWurrior or BBEdil, or on the NeXT lx>x, this shouldn’t be 
a problem. If you created your file on another platfonn (like your 
Mac), the mechanism you u.sed to move the file to your NeXT 
Ixjx should handle the translation for you. 

If all else fails, you iiiigltt try Iratislating your source file 
using the command: 

Tr '\0t5' '\012' < b^ourtiGFilE > newFlie 

Another lesson learned is that different versions of 
OPENSTEP and NEXTSTEP l(K>k and Ix^have quite difiereiidy 
from each other and from lenoiYs CodcBLiilder environment. For 
example, CodeBuilder doesiVl sup]>oit #!iiijxm (at least not in 
the same way as NEXTSTEP). Under CodeBuilder, I had to use a 
^ifndef to avoid recursve inclusion of my header files. Moving to 
a genuine NHX'I'STEP environment was really nice. 
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Behind every good Mac app.. 


Every job requires the proper tool. When it 
comes to crafting good code, BBEdit 4.0 is 
the Swiss Army Chainsaw of text editors. 


"If you have to spend time with text 
on the Mac, you should use BBedit," 

- MocWeek, September 30,1996 


• Compare source files and 

apply differences 

• Open From and Save To FTP 

• Search and replace multiple files 
using Grep 

• Navigate source files with integrated 
PopupFuncs™ technology 

• Browse project documents 




Bungie Soflwore's Marathon Jnfinity, created using BBEdft 



...is a great 
text editor. 

% 


MacLser 






BBEdit 4.0 

http://www.barebones.com/chainsaw 

To order, call 617*778-3100 



Bare Bones Software, Inc. 

P.O. Hox Bvdkitd, MA 01730 • mnm 617-77^-3100 * fax 617-778-3111 


tSBIiUlt is ii tmdeimirk ul Hsiiv SoftwflTv, IHC- All otlwr iniJi-murks iiih.i U,idi:ithdrk^ are proportKis of thar n;^pLTtive hifhit ns. 45 tlsnr BtiiKjvi Stiffwan?. Iik. 






































SmalltalkAgents’ 

Integrated Development Environment 


for 


Macintosh 
Windows 95/NT 






. O' ; 







Check out what's new... 

www.SmalltalkAgents.com 





1405 Main Street 
P.O. Box 371478 
Montara, CA 94037-1478 USA 

0Qu8sar Knowledge Sj^etems, Inc. 1997 

Windpws 96 and WindowH NT are Tratfafnartta at MicroaofL 


Tlicrc are oilier difterences ns well Codelluilder call.s gcc 
gcc, while under NEXTSTEP, gcc Ls called cc. This rcquirc.s u 
small change in the makefiles. Also, NEXTSTEP automatically 
includes the Objective-C libraiy in iis standard libraries, so there 
is one less library to include. Here's the makefile 1 used when I 
moved Shape over to NEXTSTEP: 

Shape: Hain.m Shape.m Cirde-m Cylinder.m 

cc -o Shape Main.m Shape.m Circle.in Cylinder.m 

Note I he use of cc instead of gcc as well as the absence of 
the link lilirary. Figure 5 shows the result, ninning in a Lermmal 
emulator window. Once we move into Ptxiject Builder and 
rnterftice Builder (next niontlfs column) you am say goodbye to 
all litis console business. 


Adding Cathgories to Youe Code 
O bjective<I features a metrhanism known as a category tlkit 
allows you to extend an existing class without mcxlifying the m and 
.li file of the original class. Wliy would you want to do that? The 
most obvious reason would Ix! to extend a class when you doift 
have access to the source that defines tlie c:kss. But there are otlier 
to use a category to extend a class. You might want to 
organize your class into related subgroups, I’his is especially useful 
if you are building an cxtRrmdy large das.s (you can take advantage 
of incremental compilaticjn) or if your class is txjing worked on by 
more Qian one fx^rson. You might also use categories to extend a 
class in different ways for different applicatioas. 

To implement a category, youTI define a set of methods 
placing the interface in a header file and the implementation in 
a .m file. You can use a category to add methods to a class, but 
you are not allowed to use a category to add any variables to 
the class. A category method can override an infierited methcxl 
and can get at the inherited method by sending a message to 
super. But a category method has no way to call a method in 
I he original class having the same name as the category method 
(Te., donT trreate a category method with the same name as a 
method in the class being extended). 

An example should help make this c:lear. If you rememl)er, 
last monrlVs example implemented 3 das^scs: SliajK, Circ:le, and 
Cylinder. Sfiapc is derived from Object, Circle tram Shape, and 
Cylinder from Circle. Without mcxlifying the Shape, Circle, or 
Cylinder classes, well extend the Circle cla.ss and actms the new 
tnethods from a Cylinder object. Well call die category CircleMadu 
It will add an araa and caraumference method to the Circle class. 
Here's the source code for CircIcMaihJi: 

#iiiiport “Circle.h” 

^interface Circle (CircleMath) 

- (floatlareiii 

- (float)circumference; 
gend 


Here’.s the source code for CirdeMatli.m: 
^import “ClrcieMath.h"' 

©implementatlan Circle tCtfclcHatli) 

- (float)area 
[ 






iiyhc]^» Shape 
; ITlt} 


[Srwpa inlt] 

[Circle Init) < Sat ladiLHi to 6 
[Circle imtlltHllial Set radiuai tu 33 

(Shdpe ihitj 

[Circle* ifiit] - Set radtiis bo 6 .., 

[Cylinder ioit} - 3at to 0. . 

[Ciixle litlt£zi[tiLJ3) - Sat radiua bo £7 
tCylinder mitfifldiua] 

[Cylinder irutRsdluaiheight:] - Set height In la 
nyhoat* | 


return ( (floa.t)radius * (float) radius * 3.141!iS); 


• (floatJcircumference 
I 

return ((floai)radius ' 2.0 ‘ 3,14159); 


6^0 nd 


figure 5* Running last month's Shape 
application inside the ienninul emulator. 
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WWW, neologic, com 


Download the architectural overview or view it on-line with Adobe Acrobat 

The most powerful object-oriented database engine available 

NeoAccess"* displays electrifying performance—yp to While others promise cross-platform - NeoAccess 
ten times that of the competition. Behind its elegant delivers, NeoAccess is a set of C++ classes designed for 

programming interface is a fully optimized relational use with popular compilers and frameworks on Windows", 

query engine built for speed, (t also has an object cache Macintosh*, and Unix^ platforms. Thousands of developers, 

with automatic garbage collection so your applications including America Online * and Claris'^, have already 
can run In a much smaller memory footprint than you found that fsleoAccess enabled them to build fast, powerful 

ever Imagined possible. And NeoAccess has no runtime internet applications in record time. That's why there are 

fees so you pay one affordable price no matter how many more NeoAccess based applications on end-user 
copies of your appHcatEon you use or sell. machines than any other object database backend. 


M^ 9 A/^ tosPM Padfia 


For Information and Customer Service: 


neo-logic' 

NeoLogic Systems, Inc, 

1450 Fourth St., Suite 17, Berkeley CA 94710 
V, 510,574,5897 f. 510,5744501 
ne otogic@neol 0 gic.co m 


Here's the new version of Muin.m. WeVe addetl a 
of CircleMiith.h as well as a pair of prinlfOs. The first printfO 
.sends an area niessagc to cylinder and the second printfO sends 
a eircuniference message to cylinder, 

ifinclude *CyUnder.h" 
iinrlucjf! “ClrclftHath^h" 

void mil In 0 

1 

Id fihape = [[Shape allpc) InU] : 
id circle = l lClrcie allDc] iijitREi(]lu:j:33j : 
id cylinder - 1 [Cylinder allocj initkcidius^Z/ 
height:10] ; 

prjntfl “\n(cylinder areal = %f,.An", 

[cylinder Hrea] ): 

priiitft “[cylinder clrcutfifernncel = 

[cylinder eircuaiCcteitce] ); 

[shape freel: 

[circle free]: 

[Gyllndet fteel; 

I 

Finally, here’s the make file I used: 

Shape: Maln.m Shape.m Circle.m CircleHath.m CyUnder ,bi 
cc o Shape Shape.ra Circle.n CircleHath.m Cylinder.™ 


Note that I added the file CircleMath.m to IxJth lines. Tliafs it. 
Figure 6 shows the ouipui when I ran liiLs new vei'sion of Shaj)e. 



Figure d Running Shal>e with the CircieMalh aUegfny added in. 


Tni Next Month.., 

I am very jazzed alx)ttl NEXTSTEP and tlie pronni.se it h<jlds 
for Rliap-sody, 1 can’t wait to get to WWfX: (a few weeks from 
nt>w) and find our about whai porti(ms of ilie NEXTSTEP 
framework will make iheir way into Rhaps^xly. I’ill then, we'll 
continue to expore NEXTSTEJ^ and, perhaps, make a reiurn Lo 
Java as well Got an opinion? Drop me a line... Hi 
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TOOLBOX 

ESSENTIALS 


hyjohn Shackelford, Tangeni Systems 


Creating Multi-File Dialogs in CPX 


How to build a custom file 
dialog with CustomGetfile 
and how to manage the 
dialog callback routines 


Introduction 


did (md some t'hunks or pieces^ in C and .some CPX that 1 used 
its a f jasis for MultiFilc. 

MultiFile is a CPX section. It provides a class for a multifile 
dialog of the type shown l^elow. li allows you to navigate, add 
and subtract seveml files all in one dialog sesskm. The section 
also presides a basic file dialog allowing you to specify tlie user 
prompt. However, this article focuses on MultiPile Dialog ” it 
shows you how to use the MultiPile Dialog class and discusses 
key t:t)de snipjx^ls. 


The ease that applications are built in 
CPX often masks the ncxiliility of wriiing 
low-level code for the Macinioslu 
Prograph CPX ships with a cia^S-S library 
called A[)[)licaiion building CkLSse>s (AHCs) 
which, in the world of Macinto.sh 
application frameworks^ ranks among the 
ricfiesi. Howevep one particularly useful 
chunk of code that you will not find in the 
ABCs i.s tile fancy file dialog you create 
using CusKimGctFile, 

You use the Custom Gel File feature to 
add source files to projects in several 
popular Macintosh applications like 
CodeWaiTior, Roaster or Symantec Projeta 
Maruiger. The File clas,ses in the ABCs all 
use the Standard GetFile dialog to retrieve 
files. This is fine for single file opemtions, 
hut if your upi>licalum itiust provide the 
ability lo manipulate several files at once. 
CusKrm Get File must he used to add 
controls lor coHeeling the list of files. 
Surfjrisingly, when I wrote the ccxle (or a 
CPX version of CustomGetFile, it was 
difficult to find a complete example in C 
or Pascal on w^liidi to Ixise the design. I 


Multifile Demo Application 

Tlie tlemo application opens a MukiFile Dialog and allows 
you tt> add and sublmci files. iLs [purpose is Lo demonstrate what 
a MultiPile Dialog provides (see Figure 1). The demo 
application is one of those minimal apps. It does not use the 
ABCs and has no value otlier llian showing you how tlie 
MiiitiFile Dialog looks. 


Select Files to HOd: eDMaemtosh HD 



Q Hppl0 FHtras ▼ 1 


[ Eject ] 

n 

about the MacOS 1 ^ 

[ Desktop ] 

ClDRppleCD Rudio Player 

1 IRnoleScript™ 

CUPC Card Modem Files 
rn PotuerTallc 

1 

[ Open j 

[ add ] 

r Dflfl 011 1 



§ 

[ Remooe ] 

[Remone fill] 

[ Cancel } 

[ Done ] 


Figure L The Demo Appikmion opens a Multifile Dialog^ 


John Shackelford is rlie IVainder ol Tangeni Sy.sieins — a software developtiienl company based in San Diegti. When he’s 
not playing with liis 3 diildren, he’s Isusy writing CPX code or playing the piano. He can be reachcxl at <shackx@aol.com>. 
You can find Tangent Systems on the world wicle web at <http://w'ww.tangentsys.com>. 
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Tlie Macintonh Toolbux provides a function called 
CasioniGctFile for creating custom file dialogs. Firsi, 111 show 
you the top level CPX ctxle for using it. Tluit way, if all you 
want is to use MuJtiFile and you don't care alxjut how it works, 
youH have all you need to know. 1 will also show the funcikm 
prototype and build up the a.sscK:iated functions for it in CPX, 


1:1 MultiFile Beil 


lESlii! 


MultiFile Gel; 

Top tevol rriethod for handfing a multiple file 
get dialog. The selected files are recorded fn 
an array of FSSFecs and returned as a list 
by the method 'VmultiFileGet". 

Oeveloped by Tangent Sg stems 

C'TtXT" 'SEQA' 'xD.^ 






o 




K 


To® 


Dialog” is set to the current MultiFile Dkilog in.stantx^, 1'wo other 
inetlxxJs are executed — one CR^ates a Stancbrd File Reply imial 
while the odier C'/makeCilllm:ks'') sets ii]> (xjiiiters to the ailllrack 
ilinctit>ns. Stj by design a “Tlie Dblc^” (global} holds the Multd’ile 
Dialog instance. Everything else hangs off oF that — the k>wer 
scroll list, SiandardKepiyllec and the File Results object. The 
callbacks rely on “The Dialog"' to access the scroll list, the File 
Results ol)ject ;Lnd tlie StandanJHeplyRec. 



figure Z 7he Multil’ile seciion comes with an 
example method for using MuliiFih, 


Figure 3^ Tfee **CbmtmcJor'f br MuiliFile 
LMalog sets up 3 Persistartts. 


Using MultiFile is partly straightforward — explaining it will 
Ix" much more difficult. However, as you can see in Figure 2, 
all you do is create an instance of MultiFile Dialog, setup the 
type of files ytm want with the message VsetTypeLisf’ and 
finally send the message VmultiFileGet" lo get the whole 
prexess rolling. When the method completes, the list t>f selected 
files appears on die output of “/multiFilc<}et/" 

IIow n All Works 

ril first decomp<xse The main mctiKjd “/tiiultiFileGet," descrilx 
the aUribules of MultiFile Dialog and then expose in detail the 
major chunks of cxxle that makes MultiFile Dialog work in supixrrt 
of CustomGetFile — the Toollx)x call we an: cncajxsulatitig. 

Multifile Dialog Constructor 

The first thing to kx>k at Is the c<msirutix>r for MultiFile Dialog 
( Figure 3). When an insutnee of Mulcil'ile Dkilog Is creiitetl, sevend 
atirilxitos are initialized. The “Files" attribute will end up holding a 
new instance of f'lle Results. 'IhLs oliject will evenumlly hold tlic 
F’SSpecs for the st*letted files, and it jxovides inetliods to add and 
remove FSSfxcs from its internal list of FSSpecs. “Itie attribute 
“Scaled list"" is set to NLILL. Hvcntnally, it will hold a pointer uj ilie 
scToll list item created by a ca.!! to LNew. Tlie Persistent culled ""The 


Tile method “/imkeCallbacks” (Figure 4) checks each of 4 
aitribtites in MultiFile Dialog and creates a fKanler U> a c'alllxtck 
method if a merhfxl name i.s specified, Tliis provides a nice way 
for users of Lite class to s}>eciiy their own aillback methrxLs — 
fust by specifying their own methexLs in the iniiiali/alion list Uiat 
can be fed to the Constnictor. Anti of course if iliat does not 
proviile enough fiexilrility, you can always sulxlass the whole 
tiling and define “/makeCallhacks" anew. 


1:1 MuillFile PiaMn/maKtcaiiDacKt^iianaan 

KnuttiFllff 





1 

■ip 

1 ^dialog hook proc31 I^KwdtlfSIter proek 



>>i 

1^ 

Xi 

S 


Figure 4 %nahe{7al/hacks *' checiss each 
of 4 MuHiFiie Dialog attnhutes. 


continued on page 16 
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• Create 


UP TD iZB 


With: 


Custom 


NSTALLS 


* MPROVED 


DEVELOPER 


CUSTOMIZATION 




We’ve added a new piece to the software 
distribution puzzle - electronic transactions. 
InstallerMaker creates trialware (a time locked 
demo) from your software in less than five minutes. 

^ coding required. The trialware runs for a developer- 
set number of days, prompting the user to buy at each launch. 

Automated purchase and unlocking to convert the product into a 
normal version is fully enabled via Internet, modem, voice, fax, o 
surface mail. 

Increase sales and slash costs by safely distributing 
software on the Internet, online services, CD-ROMs and even (!!) 
floppy disks. 

Skeptical? Download a free, fully functional copy of 
InstallerMaker 4.0 from www.aladdinsys.com/dev, or 
call (408)761-6200 and ask for Developer Sales. 


Aliijliliri Ire Ift.'i WMnidqe Dr^vo, CA 0SO76 Fan (408) Inwiwl dov com. 

ALAHOeN SiuiOi hniaPBrtvtiav h 8 irademarh □! Aladdin Inc Uner products m Iriidcmartcs of Itwir tespocOiV hoidtfs. 




























continued from page 13 

The local Iiicihcxl “file filter proc’^ (rigiire 5) is typical of 
the calls in “/makeCallbacks”- An improvement t>n this local 
method wouki l>e 10 verify ihal the universal method is 
actually defined and if it isn't, then fail into 3 next case and 
set the “callback" attribute (in this specific case ‘Tile Fikcr 
Callback") value! to NULL. 



Figure % This local method is typical fur what a 
ymakeCalibacks" method does. 


The meilicxJ “/multiFileCct" (Figure 6) is coinptxsed of three 
rnciluxls icsclf. The first performs the Tcx^lhix call, the second 
retrieves the selected files and the final nicihod i:leans up. 


1:2 MultiFile Diatog/multiFileGet 


Dialogs 


^ /catlCusiooiG^t ^ X | 



. -i 

i 

^ /cleanup ^ 




0;FSSt»c — 

<^1 idu 

Figure 6. VmuliiFiieCkH ” retrieiH^s a fe/ of file spedftcaiiom^ 

/ callCustomGct 

The rneLlKKJ “/callCustoinGct” (Figure?) makes the 'I'oolliox 
call “CustoniGetFile”, The MultiFile Dialog instance carries the 
values necessary fc^r the function to operate as the user wants. 



Figure 7 "/caliCuslomCeF’ makes the lotv lei^l Toolbox call 

Let’s first look at the CusTornGetFile arguments and what 
Prograph uses. 'Ibe calling arguments for CiLSloniGctFilc are shown 
below (bold) wiili ilic MultiFile Dialog Attribute ( underlined) : 
FileFilterYDProcPtr FileFilter Callback 
A pointer to an optional file filler function, provided by 
your applicationj through which CusiomGetFile passes files of 
the specified tyfxjs, 
short Num Typ es 

llie number of file types to lx: displayed. If you sjiecify a 
“Hun) Types'* value of -1, die llnst filleritig passc\s Rle-s of all types, 
SFTypelist /Type List 

A list of file types to be di.splayed. Yt)u can define it using 
the call VsetTypefJst" which auiomalically sets the value of 
atTribute “Num Types" used alxjve. 

StandardFileReply * YourPataPointer 
The reply record, which CustomGeiFile Fills in before 
returning. We create a pointer to a Reply record in the 
Consimcior for MultiFile Dialog, 
short DialoglD 

d1ie resource ID of a ciisioniized dialog template. To use 
the standard templaie, set this ixirameter to 0. The MultiFile 
Dialog defines this value to be 1001, If you want to customize 
the lcx>k of the dialog, create a new dialcsg resouae and set tlie 
DialoglD to the new value in a sulx’lass of .MultiFile Dialog for 
the “new" dialog. 

Point Where 

The upper-left corner of die dialog box in global 
coordinates. This value is predefined to lx Id, -11 which will 
place it in the middle of the screen. 

DlgHookVDProcl'tr Dialog Hook C^illback 
A pointer to the dialog hook function,, which handles item 
selections received from the Dialog Manager, lliis is in many 
ways the "meat” (1 siippo,se 1 should instead say “n[)er” for 
those vegetarians among us) of the malter; clicks within the 
dialog get handled by tfiis nieihcxl. 

ModalFiiterYDProcPtr ModalFilter Callback 
A pointer to your modal-dialog filter function, which 
determine,s how the Dialog Manager filters events when called 
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by CustomGetFilc. Specify a value of KIL if you are not 
supplying your own function. We need a modal-dialog filter 
function iK'cause we must provide scn)ll control for our saolling 
list* lliis medicxJ handles clicks in the user-defined lower scroll 
list* (Control of the upper list ^'comes" wiilt CustomGetFiie J 
short AtliveList 

ActivateYDProcPlr Activate Proc Call[)ack 
void • YourPataPolnter 

Tliese last three parameicis are not used, and are sd U) NULL, 



figure fit The default attributes are defined (o 
work ufith a dialog resource 1001. 

Figure 9 shows tlie default MultiFiie dialog (ID = 1001) 
and the index numbers for iLs items. 



figure 9. Default MuhiMle dialog (!D = 1001). 

When CiistomGetFile is called, three methods (all are 
Univemls) lake over until die user dicks ^Cancer or "Done’’ in 
the dialog window. Tliey are “hkerPrtK’", “miKlalFilterYir and 
“dialogH(K)k". Well descnl)e each in turn. 


Filter Proc Method 

The “filterProc" method (Figure 10) does one job. It is 
called whenever the upper scroll list is abtnii to be filled witli 
hies (after passing tliniugh the internal “types" filter), ft gives us 
a diance to do further proces^sing. The output of this method is 
a Boolean which determines whet lie r or not the file should 
appear in the upper lisu A TItLIE output removes the item from 
the upper list while a FALSE value allows it to appear in the 
upper list. This method checks ilie list of FSSpecs in the File 
Results object. If the file is in the File Resulrs object this filter 
will remove it from the upper list. 



Figure /ft “JUterProc” is catted whetkwerthe 
iiplKT scroll list is about u? he fitted with ftles. 


Tile field “ioNamePtr'' holds a ptunLcr to a Pascal string. 
Tlie first byte in a Pascal siring must \ye tlic lengtii of the .string* 
we execuie "get-integer” to determine the length of the string, 
and then we execute "get-texU using that value and start at iiyte 
1 of the buffer* We then check the list of file names held by the 
File Results object (retrieved with "getlale.s"). If a matching file 
name Ls found* the primitive “(in)" will return an integer greater 
than 0 indicating ihe files position in the list. In that case the 
metliod outputs TIWE, Otherwise it will output FALSE* 


Want to suggest an article for the 
magazine? Send your suggestion to 
<mailto:cditorial@mactech.com> 
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Purify on Unix 
Bounds Checker on Windows 
Now, from the makers of QC, comes... 



On Macintosh 


Mnd Bugs Fast 

SptJtUght is the fim Autc^matic Memory Debuggi^rfor the 
Macintosh. Instantly detect invalid memory accesses* bad 
toolbox parameters, leaks, stack ijverwriies, memory reloca¬ 
tion problems, and much more. 

Spotlight uses your XSYM file to automatically patch your 
application — no need to change your Muirce code. No need 
to rectJmpile. No learning curve whatsoever. 

Tlie interface gives ytHi instant feedlxtcJc when an error is 
detected. You can igrwjre the error, ignore all fumre tjccurrenccs 
of the emir, or log the error to a text file for later arailysis. 

Fine Grained Memory^ Protection 

Spotlight identifies reads and writes ouLside of die appUca- 
titm and system heap. But it dtjes not stop there. SpjrlighlV 
deject Ccxle Rq^lacemem instrumentation inspects each read 
and write rnstmetion in your code, dettJcting faulty memory 
reads and writes that occur herween blocks, in releasetl hk>cks, 
acrass multiple blocks, and in ROM. 

This tcchnoKigy wc^s on any heap idiject you can alb- 
cate: Mac heap objects, C'malloc' heap objects, even C++ 
objects created with new. 

Spotlight .stops ytHir application whenever a faulty memory 
access is alxmi to occur and display.s ihe exact source code 
line where it will happen. Tlie calling stack is showT> along 
with a display of all variables. A memory viewer si lows the 
erroneous nieniory address and ctmtents. 

Toolbox Validation 

Spotlight checks jxirameters to over 400 ttMilbox API calls, 
automatically validating handles, memory blocks, return vah 
lies, And so on. Specific, checks c'atch subtle errors si ich a.s drawl¬ 
ing into an unlocked GWorld, passing an invalid window 


IHiinter, passing an atldress within an urkvled handle to a 
routine that may move memory, and nm many more to list. 

Leak I>etection 

No more stniggling with MacsBug. On program exit Spot¬ 
light pnwjJes a clear listing of all leaked memory showing a 
full stack trace from whore file memory was alkKatoil. Instantly 
discover all leaked Mac OS objects, malloc'd objects, 
C++ objects, and resources. 

Limitations 

Spotlighr requires an XSYM file to function. MPW and 
Ccxle Warrior users can generate these directly. Symantec us¬ 
ers must use ToolServer to link with an XSYM capable linker 
Spotlight requires a PowerPC processor. 

Sporliglu works on the object cixJe. No source ctxle is re¬ 
quired: just the thing k>r Testing purchii.sed third pany libraries. 

Availability and Pricing 

Pricing tor SpiKlighr DR I is $ 199 US (plus $5 shipping and 
handling within the cominental US, $15 for international 
orders). Thi.s includes a free upgrade to ihe GM version and 
access lo ftp interim upgrade.^; leading up to GM. QC users can 
cn^grade to Sporlighi for only $ 149. 

All Onyx products carry a 30 day no questions asked money 
hack guiirantcc. 

Onyx 1 ethnology, Inc. 

7811 27th Avenue West 
Bradenton, Florida 34209 

sa I es@( X ly X- tec h .com wwwa in y x- tech .com 

941 795-7801 941 795-5^)01 (fax) 



St^wIikHt annJ tjC arc *+ Clnyx Ti'chimlcipv, Int' All (Mlwf rra,iprrwrks skc pc^jpeny iif iltt-ir ir^pt^rivu; 












Moo.\l FaTl-R YD Meihod 

The "modalFillerYD'* method (Figure 11) is called as 
part of the event processing in the window. It is needed to 
control scrolling of the lower sctoII list (the ‘"Select LisD, It 
is written such that It will only handle clicks within the 
scroll lists vertical controL 



Figure 11. "m€)dalFillei^!T cinnrok 
scwlling of the lom>r scroll ILhL 

Dlvlog H(H)k Method 

Tile '‘di 2 il(>g?kK>k'’ is the biggest of these* three methods. It 
installs the lower sen)li list the first time the hkiIukI is allied. It 
also handlers all clicks in ihe dial(3g. So for example when the 
“Add’' hution is clicked, the dialog hix)k method defines wliai 
happens in the window. 

lastead of going thrtmgh every ease of this meThfxl (there 
are 15 cases), 111 just provide an overview of what the Tiicihixl 
is supjx>sc‘d to do: 

First Time Through — Creates die lower scroll list and 
installs it in the dialog window. 

Add — Adds the filename of the selected file to Itjwer 
list. The file is removed from the upper the list through the 
file filter function. The FSSpec for the file is added to the 
File Results t>bject. 

Add All — The names of all availahle files in the upper 
scroll list are added to the lower list. The FSHpecs are added 
to die File Results object. All files ihat get successfully added 
to the File Results are filtered from the upper list display by 
the file filter method. 

Remtive — Enaliled if an itetm is selected in the lower list. 
Ihe selected item is removed from the File Results objecl, 
retiioved from the Itiwer list and added lo the upper list by tlie 
file filter method. 

Remove All — Enabled if there are any files in lower list. 
All files in the File Results object arc reincjved, all items in the 
tower list are removed. The file filter met hod then allows 
availahle files to appear in the upper list. 


Cancel — Deletes all FSSpecs from the File Resulis object, 
then closes the dialog. 

Done — Closes the dialog. 

Here is llie code of two interesting cases to drive home 
lu>w things work; what liappens the first tkiie though — that's 
when we create and install the lower scroll list —- and how Add 
works, I leave the other t:ases as a review exercise for you and 
your CPX Debugger, 

First Time Tlirough 

The first time “diak>gHcK>k’’ is executed, we must detect 
that this is the first time and display the lower list box. 



Figure 12. 7he firs! Time Ihrottgh case 
creates the Iouh^ scroll list Hem. 



figure 13. "inilLisl " ermtes a mne scroll list and places it in the 
position of windaw Hem 18 in the diaioji resource. 

Tile Toolbox call “LNew" creates a new scroll list. We 
define the rectangle for the list by gelling the rectangle for 
window item Id (sec Figure 9)* We “send” the new .scroll list to 
tlie MLiltiFile Dialog in the nic.ssagc “/setSelectlist", 
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Add file 

The Add file case iluplicatcs tlie FSSpec representing the 
selected fife and sends that FSSpec as an argument in tlie 
call to “addFtle”. 


12:t5 malogHiiok 


ttffn ■ GrafFort^ StjndardFi]«Rep1u 





tfcflm • 




7^ 




Figure 14. The '^Add'^case cads '*addFi!e” unmfnai 



Figure i5. ''addFile''unimrsa! uko 
efiahies item 19 fn ihe dialog mndow. 


The “addl'ile" universal mediod perfoniis several tasks. It 
Urst cheeks if the file can really be added. If so, it continues on 
l>y getting tlie value of the name field in the FSSfxrc and asking 
the File Results object for the numtjer of ttenis in its files list to 
form an index. It send lliose two values (name and index) as 
arguments to “addCell” which adds a new cell to the “"Select 
List". It then sends the FSSpec to tlic File Results object in a 
message Vaddltem” which adds the FSSpec to the File Result 




THf #1 SCREEN RECORDING & EOHNC UHLITY 

Fas I, simple and easy Ui u-se, Cmviera Miin^** capiures 
screen activity and live audio to a Quickl ime nKJvie file. 
For the ridiculously Iijw price of $6^J,V.S tJS, create 
dynamic tutorial, demos and prc;seniiilions. Su don’t 
be shy - download and purchase directly from 
http://www^inwg.com and gel your messuge across 
wilh CameraMan 


% 

MOTION 

WORKS 


object. Mer all that, tlie lower scroll list is redntwn in met hod 
"ufKbiieScrollLLsr and windr>w item 19 (Remove All) i.s enabled. 

At tltis jxjint "^dia log Hook” t^se 12il5 (Figure 14) outputs 
\sftlookRebiiildLisr'' and ilic melliod ends. The new item now 
appears in the lower scroll list and disappears from tlic upper 
list. Tlie multifile dialog window^ waits for the next event. 

Conclusion 

This article descrilx's the C^FX code in i hc MultiFile section. 
MiiltiFiie contains classes for ercaling special file dialogs tliat 
don't come out of lIic lx>x with CPX. T he.se cla.sses are useful if 
you need a file dialog that can deal with several files at once or 
if you want to specify a imkjue prompt in a standard file dialog. 

With the information in this article, CPX developers can 
now start using CustomGetFile based file dialogs in their 
applications. Simply atld the MultiFile section to your project, 
create an instant:c of MultiFile Dialog, and send it the message 
VmultiFilerpef. All of your problems will be solved, 
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Apple Ccmipiiter's Inside Macintosh: Files, page 3-51, 
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hy Jason Proclor, BroadQuest, Inc. 


OPENSTEP Sockets 


Network programming in 
the brave new world of 
BSD Sockets, a networking 
interface under Rhapsody 


Weudme to the Pipasure dome 

The Mucinlosh ifi ahom to take a 
large step into a brave new world. It's 
not tjuile the brave new world you or I 
expected or perhaps wanted, hut it's 
going to happen iieverlheless. Despite 
Apple's assurances to the cxjnirary, I 
expecl tfic first manifestation of the next- 
generation Macintosh 0,S to bear more 
resemblance to NEXTSTEP than to the 
current MacOS. Hence, it's a fair i>et that 
well be getting UNix-style netw^orking. 
Indeed, a large clue has appeared with 
the news that Open Transport is on the 
list of projects iliat Apple is no longer 
continuing to develof). 

Tve Iteen doing networking stuff for a 
grKxJ while, fur and NKX'rS'lTF as 

well as oilier environments; so, it seemed 
a g(K>d idea <at the time) to write an article 
explaining how' to use tlie new (actually 
rather old) APIs to do useful tilings. 

Assumed Knowledge 

llie purpose of this article is to tiest:ribe 
in detail the BSD sfxdcets API, rallier llian tlie 
ias and t^uis t>f TCPAR Hence, I'll assume 


you’ve done a fair bit of network hacking befoie. You should be 
comfortable widi IP addre,sses and port numbers, binding and 
connecting, and diat kind of thing. 

WliaBs in this article 

* 1*0 start with, I’ll dcscril)e a few major things that are 
different between die good old M;ic APIs we’re used to and the 
even older BSD sockets APIs you're probably going to liave to 
get used to. HI tlien provide a library of routines that make 
dealing with the socket library a touch easier, and fmally ill use 
tiie library to coastnm a simple server application. 

Difeerences BEmEEN Mac:OS and BSD Sockets 
Syrtchrooicity 

MacTCP, and to a Icssct extent OT, were developed for the 
MacOS environment, which Ls e.ssenlially co-operatively 
stiiediiled. Hence, making synchronous I/O calls is a Irad idea. 
Pstablishing a connection to a slow or distant site could take a 
good few seconds, during which time tlie machine can not 
respond to any user action. For this reason, these calls normally 
should be called asynchronously with one of a variety of 
strategies used to detect and respond to completion- It's beyond 
ilie scope of this anide to go into those strategics, but .suffice 
il to say that they Ixiil down to completion routine chaining, 
checking during idle time, or using a Tlireatl Manager thread to 
spin in a yielding kx>p. 

In complete contrast however, the socket library was initially 
developed for Berkeley Unix, a pre-emptively scheduled 
environment, and therefoie syncluonous calls an* liie norm. Indeed, 
there are no wclkleveloped asynchronous facilities such as you 
would find under MacOS, Ixjcause ihene Ls generally no need for 
them. Provided Rliapsody delivers on iLs pre'Cmpiive multitasking 
promise, we on all use synchronous calls and get away widi it. 


Jason Proctor is Minister of Uletjlogy fur BroadQuest Inc, a startup doing ctx>l things with the network. In past lives 
he has ernulaied PCs for Insignia, done the networking for tJie cotil but ill-fated Software Ventures web browser, and 
worked on reliable multicasting for GlohalCasi. Even though he linds himself writing Unix code more often than he’d 
like, he considers him.self a Macintosh bigot. 
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of course, tliat's nut to siiy tliat tiierc aren't any a5ynchronou.s 
facilities at all. Whilst being tmiversiilly panned for having a dearth 
of industrial-grade real-time feiRires, linix does provide signals as 
a means of being mfonned when something happens. 

Portability 

I litherto, Mac developers fiave nor had to consider 
portability Ls.sues when writing MacTCP or Open Transport code. 
QxJe written to these APIs is not going much lurtlier llian 
MacOS, even though OT is Itxxsely based on the XYl standard. 

In arnttfist again, the scx:ket library lias lx:en ported to many 
dilTcreni environ men ts» and one shcxjld always write socket etx.le to 
he |X)rtaiile, One never know'.s whem one miglit want to take one's 
fwecioiis cxxle to IMX, or anywhere el.se for th;it m^itter t'ortirnately 
however, we only Ivive one major pc^rtability eoneem to v^ony about 
— tlie scx:kel library' expends all its IP addresses and pc^ri nunilx'ts in 
netw'oric (i.e., big-endian) foniiaU By vimie of Iteing initially hosted 
on the 68k proce.ssor, MaeOS has its bytes llic t'oneci way round, 
W'hieh is why we haven’t had to wony alxjut it until now. 

So, look out for the t:onveiior routines in the code samples. 
IVe illustrated their use witli conunenis. 

Protocol Independence 

The scK'ket library was designed with a certain degree of 
[iroiocol independence in mind, lliis manifests in the API as 
socket calls taking sevenil ct>nfiguration parameters, and as 
other calls, if appropnaie. taking pointers to generic address 
struetiires — pointers to protocol-sped fie address structures 
must be cast approprialely. 

However, implcmeniing new inins|xm prot<x't)ls (,sudi as 
DDP and TCP) generally lueaas wanting kernel servers, not a 
trivial task, and the competing XT! standam.! (on which OT is 
based) provides a slightly Ix'tter interface for alternative pn>l(x:oLs, 
hence other protocols which use the stK kets interface’ are rare. 

One extra prtXtxol is normally available under standard 
BSD scxkels, tliai of fissitx domain scxkets. Although certain insitx 
systems use these for IIHT they’re generally used by normal 
people alx)ut as often as Powerlalk, so I won’t reference them 
further. Details arc available in the rpetx manual pages. 

Nej^ork API C<)nx;epts 

The BSD socket library API calls are subsuintially different to 
MacTCP and, tcj a lesser extent, 0 \\ but the adual conce[)ts one 
deals with are similar, as at the end of the day it’s all just TCP/IP. 
Hence, anyone itscd to Mxkefs. pons, connections, ;ind the 
difference iKawcen stream-based and datagram-based 
axmmunic'ation will lx off to a flying start. Basically you just do tltis: 

• Open a s<x'kei. 

• Bind to a tx>ri. 

• Establish a connecikm (optional for best^effort datagram^ 
baser I service). 

• Send and receive some data. 

• Shut down die connection gracefully. 


M,\KrNt. THE TRAtHJSmON 

We're all engineers, aren't we? On to the code. 

Step 0: Dealing with IP Addresses 

As previously indicated, the stxket libniiy neqtiires its IP numlx^r 
and port values in network (thuit is, big-endian) fonnal. It's easy to 
foigct to convert backwards and forw'ards all the time. Also, die 11^ 
acklress struauie Is radier amane, so a convenient way of acc^ing 
that jaructure Ls a big help. So, 1 use die following itnitines to make 
dciiling with the .soc ket address siruciure a touch inoie convenient. 

Listing 1: SocketCalls.c 


StfiAdftress 

Thh mininc configures an iniCTntn address siruttnrc fhim the passed in TP mimbiT and 
p(in niimbL-r paramcitTS. 

r assumption: sizcoftltmg) = si?.<;ofi(lP addreis) 7 

r itiis is not ime for IPvfj V 

void 

SfitAddress (struct sockaddr_ln *aAddress. 

uualjelled long eilPNuraber, unsigned shaft sPort) 

I 

/“ sti addpess family 7 
fl.Address->sirL.. family = Pf^TNET; 
r IP number va assui!in.'d Ui be in notW4>rk format 7 
/* this is because tP numbers are rarch’ constructed manualty 7 
/* an<l are normally cjbtarned vu name liHjkup caJb. etc 7 
aAddress >sln_addr.S_un.S_sddr = alPNumberi 
/* port number is assumed Ut be in litisi funnat 7 
aAddress->sin_part “ htons CaPort); 

I 


CietAddress 

This mvitine conftguR^ an tnicrnei addass siruciurc ikim ilie p^^uised in IP number and 
p(in numtxT parameters. 

r assumption: sizeofCJong) = sim»fi[IP adda-ss) 7 

r this b not true for IPv6 7 

void 

GetAddroBn fstruct soekaddr^in ‘aAddress. 

unnignod long ‘alFNumbijr, unsigned short * a Port Number) 

I 

f* the IP numlKT is aturtied in network romiai */ 

‘aiPNuiqber = aAddress'>siTt addr.S un,S_ndf1f; 

/* the port niinibcT is atiirncd in lto.st lormai 7 
'aPoctNuinber = ntahs (.lAHd rnss - >sln_ptjrc): 

I 


Step h Opening A ScKket 

To do anything, you must open a stxket and tell die stxket 
library what kind of communication you're ultimately going to 
be doing. When writing [a the socket library, you call socket() 
and supply the appropriate arguments. 

The socketO call takes three arguments — the protocol 
family, the type of UMiiinunication to he ustxl, and the protocol 
w'ithin the prottxol family. If we're intending to comtnunioie 
TCP/ir, the first argument will akvays be Br_INET, signif>^mg the 
internet domain prouxol family, 'flic .stx'ond argument will be 
SCK:K_S ri<EAM or SOCK_l>GRAM, according to whether we will 
be ctmimimicating via streams or datagrams. The third argument 
will be lPPROTO_TCP or f?PROTO_LIDP, according to whether 
we will lx* comiTiunicating with the TCP or HDP protocol 

N(Xe dial the Inner two arguments are of course linked. If 
you want to communic:ate using TCP, you must specify 
SOCK_STREAM as the second and IPPROTO_TCP as the third 
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aj^^uiucnt. For UDP, you inusi use SOCKJXHtAM as the seeond 
and IFPRO^rojin? us ilic third. 

Other protocol types are available froio the PFJNET family, 
siK'li iis tlie ICMP and RAW types, l>ut they are rarely used by 
clients so 1 won't go info them here. 


Listing 1: SocketCallsx 


Op^Tta^*)ckcl 

This puitinc tiptixs a Mjckei wJiith b L-imfigiircd tiir sJrt'afn-hast^ fommunicaikMi (iv<r 
■fCH 

int 

Op??nTCPSocket (int 'aNywSocket) 

( 

r internet addrtssi limiJy sin:aiii taased,T(U» 7 

‘flNt^wSockoT = socket (PF_lNIiT, SOCK.STRKAH, IPPROTO .TCP): 

It (‘aNewSocket ”= -1) 
return errrto; 
else 

return 0: 


OpraUDPSockcr 

lliis miiTinc fjfjcns a sinrkct which la conrij?mc^l for tkiORnairvhajicd communication 
over UDP 

int 

OpenUDPSoeket (int 'aNewSockcT) 

I 

/* tmernei 3(ktrcfi> Jiimily.daiag^^-linscd, UDP V 

'uNewSorket - Socket (PF_INri\ SaCK.DGRAH, IPPROtO_iJDP): 
if t'aNovSocket = -I) 
return errno: 
else 

return tJ: 


Step 2: Riniltfig A Port 

Unlike AppleTalk and IPX, TCP/IP ex|x>.ses port numbers, 
rather than raw stK'ket nurnlxars. Henee it Ls necessary to dissociate 
our socket with a fxirt numlx^r .so that we am sex? and be seen on 
the network. As is usual with TCP/IF inierfaccs, we am either 
sixxify a jx)n numlier or ask ilie jxxket library to give us thtr next 
unu.sed one. Generally, servxre would speeily a well-known |xjrt 
niimIxT M> tluit clients can hnd them. Under l'ncx, and prohabty 
Rlui[>sody, the program would have to be amning with ffx>i 
jx^miLssion to hind to a port in the server range (lexs than 1024). 
1tiis LS to prevent user processes from mast|uemding as servers 
and snarfmg jxopie's passworcLs, amongst other na.s'tiness. 

The bindO L:all takes three parameters — the number of the 
socket to be bound, the address to which the socket is to lx 
IxTLind. and the size of the address parameter Note that the 
addre.xs parameter iLsually has an address member of zero, 
signifying the local IP address of the mat:hine, liowever this 
neetl noi lx the case. Multiple IP addres.scs can be supported, 
and this is how web servers accomplish virtual hosting. 

You'll notice that there’s an extra cal! rn the BindQ routine: 
the setsockoptO call. I’his call gives Life TCP stack [xmiission to 
bind to the same pon each time. Otherwise, the stack imp<ises a 
2 minute delay bclwcen binds to the same pf>rt. This delay Ls to 
guard against the following sequence f)f events: 

• Local endpoint opens a socket and binds to pon n. 

• Remote endpoint establishes connection with fK>n n, 

• Uk-uI cnd{x?int tiisconneas in a dis< orderly fashion; remote 
endpoint is not aware cf>nnceLion has Ixen dropped. 
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• L(x:ai endpoinf opens another socket and hinds lo port n, 

• Remote end|X)int sends packet to port n, believing previous 
connection is still up. 

• Ltgral endpoint receives packet from previous connectioii. 

• This Ls bad. 

'l hankfuliy, this liappen.s very rarely nowadays. 

Listing 2: SockelGills.c 


Bind 

Mils routine associates a port numbci' with a socket which been openei! via the 
socketO call. If the port miniljcr is 2 xrro, the next available prirt number is aliocatcd 
from dyiximic port space tie ouUiiiJc the server pnn range), 

int 

Bind (int aSocknt, eirucL sockaddr_in ‘ aLocalAddrfts#;) 

I 

int on ^ 1: 

assort (oLocalAddress): 
r say it's OK to reuse our addn^s 7 

setnockopt (aSocket, S0T.„$0 CKETh SO_REttSEADDR. Aon, sizeof 
(on)); 

if (bind (aSockpi, 

{ntcLict fiockfiitlclr *) aLocalAddtoss. 
sUcof (struct sockaddr_in) 3 = 0) 

I 

teturn 0; 

I 

else 

I 

roturn or mo; 

I 


Step 3: Establishing a Coimecdon 

Establishing a connection is mandatory cinly for rclial>le, 
.stream-based communication. Witliin the TCP/IP family of 
protocols, at least at the network/transport layer, lhi.s means I'CP. 
If only lK^st-effo^t, datagram-based (that is UDP) communication 
is required, conncaing is not required, althouj^h if connect() is 
called on a UDP socket, this fixes the source and destination for 
further communication, 'Phis can lie handy if you want to use 
unicast UDP but don't w'ani to validate that the remote address 
is c:orrect each time you receive a packet. 

Connections are initiated via the connect() call. Tliis takes 
three parameters — the local s<K:ket numlx^r (which must t>e 
iK)und to a port), the address of the remote endpoint to connect 
to, and the .size of the address parameter 
Listing 3: SocketCalls.c 

C.onncct 

nib niutinc intijates a cimitatiim with the rctivoKf address. For TCP six.-kcLs, this 
aoually negotiates a conncciion. For UUP sockets, it simply fixt'S the remcjtc address. 

int 

Connect (int aSocket. struct sockaddr^Jn ’aRomot^Address) 

{ 

assert CaRemotcAddress); 

if (connect {a Sofiko i, (struct sockaddr *) aRomotoAddress, 
si^aof {struct sockaddr_in)} = 0) 
t 

return G: 

] 

else 

{ 

return errno; 
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□.srening f()r inconiing connections is ^iccomplislicd with the 
lislenO call, and accepting with the acc8pt() call. 

Tile listenO call lakes two arguments — the local MKkel 
number, which must lie Ixjund to a port, anti a numlKrr signifying 
the “tjueue Icngtli”. The latter is simply how many incoming 
cormeaions can lie hekl unaccepted — any more are refused. 
Generally, ytm would want to tailor this numlier ac:cording to 
how many rec|uests you are serving in a given time jieriod. 

Tlic acceplO aiU takes three aigumenls — tlie loc^tl stx’ket 
numlier. which must Ik^ Ixxmd to a poit, a pointer to an address 
stfudnre, and a jx^inter to an integer wlikh is i^ilialii^cd to the size 
of the address suncture. 'Ihe address sirucLunc and size argument are 
filled in with the address of the cndjxiint initiating the connection. 

Note that the acceptO call retorns a new socket, which is die 
connected scK'kct over which all tbiia transfer sliould Ix^ done. 
The original scx'kei is dedicated to w^aiting for incoming 
connections, and should not lx used for any data transfer. In dus 
w-ay, there is always a scxket wailing for an incoming 
connection, and incoming connect ret|ucsts cannot be lost* * 

Listing 4: StK'ketCallsx 

Aui.'cpt 

nUi muUtic listens for an incofUingTCP cfmnccUofi. 
int 

Actrept (int aSocket. sjtmct 30ck3ddr_iri *aReiaoteAddress. 
inr ftQiieueLenf^th. int *afl«wSotkcst) 

I 

int addresaLength: 

assert (aKemott:Address) ; 
assert (aKewSo c kc l ) s 

r lisitnO is intiiuka lira’ for rlariiy V 
t technically, imc musi only oil listcnO once V 
if (listen (aSocket. aQueueLength) = 0) 

I 

addressLength sizeof (struct sockaddr„in)i 

•aHevSocket = accept taSocket. 

(struct sockaddt *) aRemareAddress, 

&addressLength); 

if (*aKewSocket > 0) 
return Of 
I 

return erttiof 

Step 4: Sending and Receiving Data 

Sending and receiving data c:an lx as straightforward as 
UKix file I/O, providing the scxkct is connected and no special 
options have to he set on die data to l>e sent. Normal unix read() 
anti writeO work just fine. However, the Mxket library does of 
course provide primitives for sending and receiving data in all 
cases, and clients generally use those. 

The calls are split into two groups, for connected and 
unconnected sockets. For connected srxJcets. the sendO and recv{) 
calls are e?isential]y ilic same as wnte{} and read(), exc’ept iliat an 
additional flags ivarameter provides a met:hanlsin for associating 
special options with the ciata. Ti'S Ixyond the scope of this article to 
go into the optioas. bul undc manual pages can provide full details. 


For unconnected (that is, UDP) sockeLs, the call.s are similar, 
bul with die addition of sepamte destination (for s6ndto()) and 
source (for recvfrom{)) parameters, and assfxiaied address size 
parameters. You must specify the destination for a .send on an 
iinc:onnected scx'ket, and provide spac:e for die source of a 
packet receivc*d on an unconnected socket. 

listing 5: SocketCalls.c 


Send 

lltb rnuitnc sends the passed-in ehunk uf iLfitit to Uic other end of the coooeetioti. 
unetmiiecietl UOF sockets, see SendToQ 

int 

Sr^nd (Inr. aSoeknt. void 'aDaiu. Ini ahfingth) 

I 

(afJatn): 

assert (^Length )i 

If (send (uSockot, aData, aLangth, 0) “ nLnnglh) 
return 0; 
else 

return errno: 

I 


ScfkITo 

'litis louiinc scuds the pxssednn churik of lUti to die specified address and porcThe 
s<M:ket must be micouciected. 

int 

SondTo (int aSocket. void *a0ata. IfR al-ength, 
sLruci .'5arkaddr_ln *aDestination) 

( 

assert (aOaia): 

assert (aLength): 

assert (^Destination); 

if (sendto (aSocket. aUala, aT-ength. 0. 

(struct sockarfdr *) aDestinuLlon. 
sizeof (struct sockflddr_in)3 = 0) 

[ 

return 0: 

I 

else 

I 

return errno: 

I 


Receive 

Thkt ruulinc ardves data from the other end of A cotuicctioii, up to the amount 
specified in die i>aranK tcTii. For acqxkm tm uncotvnectci! UDP sockets, see 
ReceiveFfomO. 

int 

Raceivc (tnt aSocket, void *aData. int 'alHcngth) 

[ 

int Gc; 

assert (aData)i 
assert (aLength); 

cc ” reev (aSocket, aDaia. ^aLength. 0); 

If (cc >= 0) 

I 

r note that zem aedve KajcraJly means orderty shutdown at the other end V 

* a Length cc; 
return 0; 

1 

else 

( 

“aLength ® 0: 
return nrrno: 

I 
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KcccivcFrom 

This rautinc receives data frum an uncormetted UDP pt>rt. 
int 

Rec^lveFrom 

(int a Socket* void "‘uData, Int *aLength, 
fitruct sockadd:r_in ’aSource) 

I 

Int ec ^ 

InL addressLength; 

assert (aData); 

assert (aLength): 

assert (aSource ); 

addressLengLh = sizeof (struct scckaddr in); 

cc = recvfrom (aSocket, aData* *aT-cnglh* 0* 

(struct aockaddr *) aSourco, AaddressLength); 

if {dc >“ Q) 

t 

*al*ength = cc; 
return 0; 

I 

else 

( 

•aLength “ f]; 
return errno; 

1 

I 

Step 5; Shutting Down the Connection GraceftiUy 

'I'CF clients are happiest if they notify one another when a 
connection is going clown. Amongst other ix:ncfits, graceful 
ciisconneclion means fewer packets transmitted on dead 
connections, which is a gotid tiling for everyone. 

Under Mac'iCP and OT, orderiy disconnection is a rather 
messy prexoss involving closing the kxiil end and then wailing 
for the remote to close its end. "there are a few different 
situations to survive and most 1 lackers will prol>ably say this is 
tile gnariiesi bit of cfxle for these APIs. 

Orderly disconnetlion under scxrkets however couldn't l)e 
easier* laigely becaUsSe the protocol stac'k handles all the nastiness 
for you. The shutdown() call takes two [niramelers — the socket to 
be affected and an integer specifying which ends of die 
connection to close. If die second panimeter is zero, further 
reception is prevented (that is, the remote ent! Ls tiosc^Dj if it is 1, 
further trarcsiiiission is prevented (iliat Is* die liKtil end is ckised)' 
if it is 2* Ixxh ends are closed and the €f>nnection is tom down* 


is, zero laminated) spei:ifying the name to look up* It returns a 
pointer to a static slRictuR' describing the host, with IP addtessses 
anti other names that host niiglit (tave, ainongsl other details* 

Tlie kicker with the structure returned by gethostbyname() is 
that it contains a list of pointers to IP addresses, rather than 
copies of them* '111is is to enable a certain amount i>f addre-ss size 
independence* Hence one must copy ttie addresses out of the 
structure* I've lost count of the number of times I've forgotten 
this detail and sat there wondering wliy the addresses I'm getting 
back are complete crap* 

listing 7: SocketCalls.c 


IliLs nmtinc look;; up the pa^csc-d rtamc and places Uic Jirst address Ln the 

pa.v^ emtput paninneier. 

Int 

LoakupNutae 

(char ‘aHostNante, struct *wckaddr_in ^uAddeesa) 

I 

struct hostsnt *hp; 

aanert (aficstNainu] : 
as**?crl {aAddreSH); 

hp “ gethoStbyname EaHostName); 

if (hp) 

I 

/* size <>f addres.s nciumcii b pr(jtoct>l-depepdail V 
fiicmcpy (tfuAddreBsOBfln^addr, bp'Mi addr list fO] * 
hp- >h_length) ; 
return 0; 

] 

else 

t 

TPturn h_errno; 

1 

I 


BlJaniNG A DtXJOMEOT Skkvfr 

Tins is a simple Il'ri'P-type dtx:umeni server that kx>ps 
accepting TCi^ connections on a user-sjx*cifjed jx>rt numlxT 
(defaulted to 8tX)0)* When die pnigram succes*sfully accepts an 
inct)ming connection* it expects a file name followed by a carriage 
mtum or line feed* The server then atlempis to open the file and 
semd tile contents down the TCP connection. Server-side errors are 
signified by t!losiiig the ainnectian before any content is sent 


Listing 6: StxrketCallsx 


This fuiitine tlfcsctinmxis IhjIIi tiids uf a curincctcd socket. 

Itii 

Disconnect (int aSocket) 


Disconnect 


if (shutdoiim (aSocket, 2) “= 0) 
return 0: 
el se 

return errno; 


Domain Name Lookups 

Domain name lookups are generally pciformetl by one routine 
— gethostbyname(). TIiLs call takes one parameter — a C siring (dial 


Listing 8: DocijmcntServcr.c 


Malnlinr Idr the (kxrumcni server 


If Include <urriiu*h> 

#Include <fimtl*h> 
tfluclude <Xibc.h> 
^Include <netdb*h> 
#include <Tietinet/in*h> 
finclude <stdiQ*h> 
iflnclude <sy*^ / socket *h> 


r ermo extern 7 
r fur file open mutle 7 
/* for generic ANSI .stuff 7 
/* ft>r lookups 7 
/*forPF_TNFrstufr7 
r for priiUfO 7 
r for socket API 7 


Ideflne kDeraultPortNuraber 8000 

^define if(!Cx)) \ 

printtassertion fflilureXn" 

Int 

main (int arge* char *argv (]) 


_PTL£_. _LiNE_): 
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Mac, go out and touch the world for 

ADB I/O lets your customers' Macs ccy>trol things, il lets them f§2£[. 

I ADB I/O lets the Mac be part of the physical world- 

W Thousands of Uses 

Science, Multin>edia, Children’s Museufns, I loTTie AuUxna Lion f ^ 

H&WJ Theatre Stages, Industrial Testrng, Medical Research, Bonsai 

Watering, Robotics, Weather Stations—anything that can 
be electronically measured or controlled can use the ADB I/O. 

No Serial Ports Ocxupied ^ 

ADB f/0 L^es the Apple Desktop Bus to communicate inputs and 
outputs to and from your Macintosh. (Maximum polling frequency 
is 90 Hz,} No external power supply is needed. 

Eight I/O Channels Provided 
^ hour relays for output- hour channels for Digital In, 

Extensive Software Support 


yY X-JBEEHIVE / ^-'O/ 

jTy C_ TECHHOLOQIES 

Tlufr lilf^'Tcch Cottd4« lMdutitry.A'~"‘^ir^_ 

C«t»pcrativir Otj Inlftmct/ ^ r £ ” 

*ADB I/O supports three languiige environments, two scripting iarivironitientSj multimadis d^lo^Stnent $(^iiOflatieitls, and other sp&dfic a|0|}ij|ptiiq!^r^ 
with more ort the vvi3(y. Visit our horns page to find out more and to download the complete mariual as well as alt supporting software ^ 

(818) 304-0ee4 wiksa. e-maiit: bofttft(?t<^mail.bzzJizzz.^ {BIBJ 5€S-1530 fax. © 1997 BeeHive Technolog les^ the. Afljights 


char 

Int 

Int 

itit 

int 

int 

int 

int 

fitntct aor.kaddE In 
Struct sorks<ldr_tn 


buffer [T02Vj] ; 
accnptingSocket t 
amouniRend; 
amonniRcccivod; 
dataSocket; 
fd; 
i: 

porti^umber; 
local; 
romor f! s 


/* make a MK'kct */ 

if (OpenTCPSnckGt (^acccptingSocket) 0] 
I 

petror ("socket"’); 
exit (1); 

1 


/* allow Si lting of |ion niiiiifk.T by nigumcnts */ 
if (arge > 1} 

( 

portNumber - atoi {argv 11]); 


if (Bind [acceptingSocket, l^local) 1= 0) 

I 

porror ("bind"): 
exit (1); 


r kxjp accepting incoming connections 7 

while (Accept(acceptlngSecket, &remote, 5. fi:dataSockGt)=0) 

t 

amountReceived ^ slxeof (buffer): 

if (Receive (dataSocket, buffer, fitamonntiiecelved) = 0} 

f 

r assumption: wc receive the fUc name In one chunk 7 
for (i = 0; i < atnotmtReceived; iff) 

I 


if [Lufrer lij — -\r^ II biifrer [ij — '\n'} 

buffer LiJ ^0; 
break: 

[ 

I 


If (portNumber ^ 0) 

portNuuiber = kDefaultPor LN umber: 

) 

else 

I 

portNumber = kDefaultPortNumber; 

I 


il (i = amountReccived) 

I 

/• we did 11 'E find a CR/H in ilie diuiik 7 
I 

else 

I 

P tipcn up the tile 7 

fd - open (buffer, O.ROOWT.Y); 


prinlf ("listening on port %d \n". poriNiiJiiber); 

P set up our binti address V 
P note the address is zero, for the local address */ 

P the port number is expected in host fonmu V 
SetAddress (&local, 0, portNumber); 


if (id = -.1) 

t 

P couldn't open the file 7 
perror (buffer): 

J 

else 
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TCP/IP Scripting Addition The Internet Scripting Solution 


The TCP/IP Script mg Addition allows you to quickly 
develop Internet client/server applicalions using 
AppleScript® If you want to script with MacTCP and 
Open Transporthere's your solution! 

# Supports Script Editor, FaceSpan and HyperCard^*’ 

# Build net-wise WebSTAR CGI scripts 

and NetScapeCCI scripts ^|J 

♦ Sample scripts include FTP, Gopher, 

Telnet, Post Office, E-Mail and more 

♦ Featured on the Apple® Internet Server 

Order now through the MacTech Mail Order Store at 
805-494-9797 or other mail order stores 





Mango Tree Software, Inc. 

Box 1057 • Brookline, Massachusetts 02146 
617-327-8663 

http://www.mangotreexom/biz/mangQ 


Alt trademarks are properties of their respective holders. 

Coni ad Mango Tree Software frtr site licensing and redistribution infornnation, 
Copyright © Mijngo Tree Software, Inc. 


FTP Parameters 




j1 


Set these paran 
Csending) files i 


FTP Host 
Directory 


Telnet Libre 


W6 


User ID 
Password 


Type of file trai 

O MacBinary File 


besoriptionT 


Telnet Library v1.0 

Copyright © 1995 Mango Tree 
All Rights Reserved 



iil 

■:U'l 

apjl 


* .* ¥ » * # s 




set my_telnet_stream to tel ns 
tell my_telnet_stream 

try 

connect(your_host) 
read until textf "loc 


I 

do 

[ 

r read a chunk from the file V 

amountRead “ read (fd, buffer, sizeof (buffer)): 
if (amoinitRead > 0) 

I 

r send whiii we gut down the connection V 
if (Send 

(datafJor.ket, buffer, amountRoad) J= 0) 

1 

/* the kiUiatof lia.s probably cliiscd 7 
perrar ("send"); 
break: 
i 

) 

I 

while famountRead = sizeof (buffer)): 

I 


else 

i 

/* couldn't read th>m the connection V 
r the remtue end has pmhably closed */ 
perror ("reev"); 


Disconnect (dstaSocket); 


Further Rfading 

Any UNIX manual pages will give yt)u copious infomiation on 
die socket libniry. Simply type ^'iTiari soeked" at any available shell 
prompt. Unfortunately however, the man pages have a tendency 
to provide amazing detail without acttialiy telling you how to do 
any tiling. Wlien 1 lirsl got into networking, tile UNIX manual pages 
misled me so much that I actually thought AppleTiilk w^as easier to 
use than .sockets. Nothing could lx; further from the tnith. 

There are several good lx)oks t>n the scxjket library in 
particular and TCP/IP in general. Lots of people learned tlieir 
'rCP/lP from Dougla.s Comer's seminal work “Internetworking 
with TCP/TP”, in ai least three volumes with lots of quality info. 

Also worth a look is the Addison-Wesley series 
“Illustrating TCP/IP", in at least three thicker volumes, 
rhese live up to the high standard maintained by A-W's 
ITofes,sional Computing Series. SI 


Want to know what products are 
available for MacOS 
development? Check out 
Developer Depot^^ 
<http://www,devdepotxom> 


] 

psrror ("accept”); 
exit (L); 

r NoiRiiAciimv 
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FROM THE 

FACTORY 

FLOOR 


by Dave Mark, ©1997 by Metrowerks, Inc.i all tights reserved. 


/A 


metrowerks 


The Code Warrior IDE Team 


'Ihis month’s intei’view is with the 
folks responsible for the latest rev of the 
QxleWarrior IDE. The niemljcrs of Llie IDE 
team: Dan Podwall (technical lead), Kevin 
Bell, Matt Henderson, Glenn Meter, and 
Rob Vaterlaus, 

Dave: rm very excited about the 

release of version 2*0 of the 
CodeWarriof IDE* What are some of 
the new features? 


features. In fact, die new IDE is faster than before. In onr 
tests, builds are usualiy around 30% fastcT. Initial ituilds, 
where the IDE has to seardi for include files, are up to twice 
as fast as in 1.7. 

'Die proiect window now has three dffierent views on the 
project to acct>mm(xiate the increased power, Tliere are now 
optional toolbars in die project, editor, and browser windows, 
and there’s a whizzy new interface for customizing them. 
Keyboard shortcuts are also customizable via the Key 
Bindings preference panel. 


Dan: The primary new feature is a 

ground-up rewrite of the project 
manager. We gave the old code a ciecent 
burial and then sDned frem scratch. 
WeVe teimed a lot in the four years 
since CodeWarrior DRl sliipped and had 
a long list of user net]nests to address, 

ITie project manager can now build 
multiple exec:utable files from a single 
project. Tills cdu be variations on a 
single application, such as 68K and 
PowerPC versions. Or it could be 
ariytliing else CodeWarrior supporl,s, 
such as libraries, code resources, or 
shared libraries, 

A project can also link to otlier project 
files, and build those subprojects 
during make. And of course you can 
have more than one projecL open at a 
time. It's very flexible. 

The build .system is now threaded and 
can handle die requirements of C++, 
Java, and Pascal in a very general way. 

We were very conc'emed about not 
slowing down builds with all these new 


Dave: What impact will the new threaded execution have 
on the user? 

Dan: The main benefit is that you can do other things in the 

IDE wliiie a make is in progress, including editing, brow.sing, 
checkin/checkout and multi-file search. So if you gel compile 
errors during a make, you can start fixing them while the rest 
of your project is still compiling. 

We use Apple’s Ihread Manager to run the build in a 
separate tliread from the user interface. We’re planning to 
thread other features in the future, such as version control 
and multi-file search. Not only does this make for a more 
responsive user interface, bur well be ready to take 
advantage of modern operating systems like Rhapsody as 
well as multiprocessing hardw^are, 

Gleim: To give .some example,s of how threads work togetlien 
let's look closer at what happens during a build. Under the 
old IDEs, all compiling and UI happened on die same 
tlircad. So, there was not much you could do during a build 
but wait for it to finish. Under the 2.0 IDE, as Dan pointed 
out, builds happen on a different diread than the UT. This 
means that you am still open files, use the browser, pedorm 
searches, anti even edit files during a build. As the project 
state is changed during the build, messages are sent from the 
huikl thread to the tither thieads to let them know^ about the 
change. Wlicn liie UI tliread next gets a slice of time It will 
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read messages and update the projeet window and 
browser windows, for example. 

Dave; With miittiple targets per project, will I be able to 
build fat binaries? How about separate debug and 
release versions of my program from a single project? 

Glenn; Ln the 2.0 11^1% each ‘"target” matches what used to be a 
1.7.x '"project”. Racli target includes a file list, segmentation or 
link order, and preferences to build an application or library, 
liel’ore 2,0, to build a Fat applic-ation you would usually have 
(wo pr£>jec:ts: one to build the 68K app and anodier i\m would 
build the PowerPC eode and include the 68K app to leave a fat 
application. Ibis nieani that whenever you needed to u[xlale 
your upplicaiion, you'd have to l>e keep the two projects in 
,sync. In the 2.0 world, the same thing can he done within a 
single project. 'Ibe KillerApp.|i project on have one Utrgel to 
build the 68K app and anotlier to build tlie PowerPC ccxJe and 
cTeaie ilie fat application. Maintaining tile project Is easier since 
we c'an now^ help you add or remove Files Fnini ixHh targets at 
once. You 11 still liave to set prerereiices on a tiirget by taigei 
basis, l>ut that will lx impnived in a later release. 

Once you’ve got related targcLs in the same project File, you 
can use tai^ei de^xodeneies to make your life even easier. 
For cxainple, if yf>u have a 'Killer Engine" shared library tliat 
is used by the Killer application, yon can set the apphealioii 
target to deptaid on (he shared libraiy target and to link 
against its oulpuL Then, whenever the application is built the 
shared library will automalkally be brought up tn<!ale. Also, 
if the name of the sliiired library is tiianged, ihe name will 
a\m get changed in the application's File list. 

Iwo new linkers are included in the 2.0 IDH to sufifKirt 
working with multiple targets. The "MacOS Metge" linker can 
lx used lo merge code and resr)urees into a single lile. So, 
you could also build separate 6HK debug and release tatget.s, 
and use a third target with (he meige linker to build the fat 
application. The other new linker, the ‘'None” linker, actually 
drjcsn't generate an t>utpul tile. It can lx ustxl to t'reate 
*"1x11 Id-only” targets to automate building a .set of targets 
without .scripts. For example, you could add a “Build All” 
largel that depends on all other targets and uses the “N{>ne" 
linker. When the '“Huikl All” target i-s built, all of the other 
targets will Ix" hrotighl up-to-ilate without liaving to leave a 
dummy output file. This is esjxdally useful wlien generating 
groups of applications, libraries, or plugins. 

Mam Targets are managed Irtjm tlic targeLs page in the project 
window. From ilie targets page, you can create new targets 
tliat are either empty or identical to some other taiget in the 
project. Onc'e ytHiVe created a new largel, double-clicking it 
will allow you to edit its settings. This is an important 
difference Ixtwxxn CodeWarrior 1.x and 2.0. Linguage, 
coclegen, and all the other .stuff that wa.s configured witli 


Project Settings dialog in 1 .x are now targets .settings, so each 
target in a 2.0 projea can lx configured however you like. 

Building debug, release, 68K, and PowerPC versions of your 
program is mostly a matter t>f adding new targets to your 
project. ’^Tien you convert a project from CocieWarrior 1.x, it 
w^ill start out with one target that's t:onfigured exactly the 
same as the project you converted. So if you converted a 
PowerPC project configured for debugging and wanted to ix 
able to build a release version of your app, you would create 
a new target using the 'Clone existing target” option. 'Ibis 
produce.s a new Largel identical to the first, so all that would 
be left for y<}U to do would be to edit the new- target’s settings 
so they're configured fix shipping instead of debugging. 
Likewise, Lo create a 68K laiget. you just clone an exisTtng 
taigcE and change the new target to use the 68K linker. 

It’s easy to .set up a target to build a fat app as well. Simply 
drag a 68K and a Pow'erPC target under the target that you 
want to be fat, and a target depc^^de^cy will Ix! .set up so that 
the 68K and Pf>werPC largcLs will lx‘ built whenever die far 
target is built. You1l also have to turn on the “link outpur flag 
for your 68K and PPC subtargets by clicking in tlie Link 
coluinn (w'hich has the chain link icon at lop). The “link 
output” flag tells the IDH to link the output file of a subtargei 
into Lite output file of the main target. 
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f ilgiif-e /. The CodeWarrior 2.0 IDB stippi^rts multiple targets 
within the same project. 

Aside from different settings, taigcLs can contain different files, 
Olwiously, you wouldn’t want to include a PowerPC-specific 
libraiy in a 68K taiget. We’ve introduced a new feature, the 
Project laspector, to allow you to examine and change which 
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targets a^ntaia liie files in your project. The Inspcekir always 
■‘ins|xx:ts” whichever files are atrrently selected in the files 
view of tlie project w'incluw. So, to move a Fowerl-^CT.specific 
library out of a 68K uitget, you would simply select the libraiy, 
t:h£Ki.sc the “Project Inspector" command from the Window^s 
menu, uncheck the checklxsx for the 68K target, and the press 
the “Apply” hiutori to save the change. Once the change has 
been ap}>lied, die library will no longer he a part of your 68K 
taiget. The Inspector works on all selected items, so if you 
have several files you need to inspect, use command- or sliifi- 
click to sclea them all at once. 



figure Z Ihe CodeWarrior Project hisf^cctor 

Dave: Tell me afKiut nested projects. Can 1 build a shared 
library as a subproject within an app that depends on 
the shared library in order to run? 

Rob: With 2.0 you can include another project in a urget in 

much ihc same way you include normal stiutre files in a 
target. You can select which of die targets of the subprojea 
you wtint to have built w'hcn you build the main largei. You 
can also set wlicdicr or not the main target links against the 
sub[>roject target. You would .set this Hag when the subproject 
is generating a shared or static libnuy. 


main project Ls set to build and link against the corresponding 
uirgei in the subproject (e.g. the FPC Debug target in the 
main project builds and links against the PPC Debug target of 
the l^owerPlani subproject). When changes are matie lo the 
library code tlie subproject will only gel rebuilt ihe first lime. 

Another situation whea* subjirojects would be preferretl over 
using multiple taigcts is if you had a prcKluci that used a 
plugin architecture (e.g. Photosliop, AfterDark, or 
CodeWarrior), Yott ccnild liavc one giant project with a target 
for each plugin and a master build laiget tfiat find a sulmirget 
for each of the plugin targets. The drawbaek to structuring the 
project that way would Ik- tliat if someone was jiLsr doing 
development on a single plugin they would still need to i>e 
working with a project that included die enlirc^ source code 
base which would l>e unwieldy. 

A l}C‘Ucr way to oiganize the projeris would be to have 
individual projects tor each of the f)lugins and then have a 
master project lluii included all the plugin projecLs as 
subprojects. Tiiat way it w'oukl be more convenient to work 
on individual plugias, bur you could still do a complete build 
of the entire prodiK'i in a .single make of the master project. 

Dave: Must 1 rebuild all my projects to take advantage of 
tliis new architecture? 

Kevin: The 2.0 IDC uses a new^ project formal. You can convert 
your old projects using the Project Converter that comes witli 
the new Wlien converting, you have rw'o opiions: you 
can mcTge multiple i.7 projects into a single mulii-target 2.0 
project, or convert projecLs individually. Converting projeas 
individually will create single target 2,0 projects which work 
the same as die original projects. Merging T7 projects allows 
you to take advantage of new 2.0 features. For example, if 
you Iiave two 1.7 projects w'hich create 6HK and PowarrPC 
versioas of your application, you CAn merge these together 
with the converter to get one 2.0 project which has bSK and 
PowerPC targets. If you w^ani to build a fat version of y<Hir 
app, you can create a third target which uses the merge linker 
to combine the outputs of the 68K and PowerPC targets. To 
avoid getting lots of duplicate resource warnings youll 
probably want To move the resources to a separate uirget. 


In many cases the same objective can be achieved using either 
multiple taigets or suhprojecLs, Multiple taigets are generally 
preferred when you have different versions of the .same code 
(e.g, PowerPC ik 6BK, Debug Sc Release, dilTerent lDcaIi 2 ed 
versions) and you want to build iIilmh in various combinations. 

SuhpnjjecLs are nice when you have a library that is shared 
among many projects anti yott warn to only have to build it 
once. For example, many of our projects have subprc)jects for 
PowerPiant and/or MSL. The subproject has multiple targets 
for PowerPC 8l 68K, Debug ^ Release. Each target in the 


Dave: WhaCs tlie story behind the new, configurable 
toolbars? 

Kevin; Tlic IDE now has user configurable totdbars in the editor, 
projea, and browser windows in additkm to the floating 
tooll')ar. You tionfigurc die toolbars by dragging command 
bimon.s, popups, and other elements from a new element list 
window. One of the biggest ptoblems I had with the 17 
toolbar was that you almost had to leave it visible Ix'cause 
that'.s where tfie IDE reported all siatus infonmition during 
builds, file searching, and other ojxrations. In the 2.0 LDE, thi.s 
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staiLis information is shown in other places so you can hide 
the toolbars without missing out on important information. 



Figure i The Toolbar Element list, imd to 
configure your tmlburs. 

Dave: Can you tell me about the Visual Source Safe plugin? 

Riih: When version control Is enabled in ific IDE, an extra 

Version Cc)ntrol System (VCS) menu is added to the menu bar 
The menu includes commancLs for all the common VCS 
commands like Get, Check In, and Check Out, There are 
recursive variants of all the commands so you can iterate over 
entire directory trees. The commands can be used from the 
editor and browser or with the selection in the projea window. 

The 2.0 IDE supports version control through a plugin 
interface, so we can support many different version control 
systems. The plugin API defines abstraa VCS operations; a 
plugin implements these operations for a sjxtcillc version 
control system. Our CtxleManager product includes a plugin 
that lets you access Source Safe databases. Several people 
have come out with shareware plugins that let you use 
Projector databases and we are working witli other VCS 
vendors to help them develop plugins for their products. 

Some of the improvements weVe made In the IDE really 
help out with using source control with project files. In 1,7 
the project contains all the object code, dependency info, 
etc,, so you need to make the project file writable just to 
he able to open and build it, in 2.0 the project file only 
contains the structural information about the projects the 
list of source files, subtargets, and settings for each target. 
All the data generated during a build is stored in a separate 
per-targer data file. Tins means you can open and build 
projects without having to check them out. You only need 
to checkout the project when you add new source files, 
change die setling.s, etc. 


When you get a new version of a project from the database, 
if any tiles have been added or deleted, the IDE will 
synchronise the target data with the new project file to figure 
out which files are new and need to be compiled. If the 
compiler settings haven't changed, you will not need to 
recompile any of the files that are unchanged from the old 
version of the project. 

Another nice improvement is that we store the VCS settings 
in a .separate per-pro|ect settings file so each user can 
configure VCS with their user name, pas,sword, and local root 
that won't get replaced when they get a new version of the 
project from the database. 

Dave; Any other features you'd like to mention? 

Kevin; The keylxiard equivalenLs for IDE menu commands and 
editor actions are now customable via a new preference panel. 
Any key combinations can be used, and emacs-like prefix keys 
aie supported. Each ctymmand can be bound to two keys, so for 
example, emacs-addicts can bind control-x c.xmtrol-s to save and 
the standard conunand-s would still work. 

Matt: One of the most requested new features is that you can 

now have multiple projects open at the same lime. Perhaps the 
mast obvKJus change, though, is diat die project window has 
a completely new )iK)k — it's now divided into separate pages, 
'llie Files page contains die hierarchiL’al li.st of all the files in the 
project. This ILst is for you to organize your files however yt>u 
want. You create as many levels of nested groups as you 
like in die Files page, and the order of files doesn't affea the 
way your project builds, Tlie TaigeLs page is, of course, where 
you create and configure the targets in your project. This page 
has a liierarchical list of your project's targets and their 
dependencies and subprojccLs. You1l al,so see either the 
Segments page for 6SK targets or the Link Order page for 
PowerPC and Java targets, llie Segments page lists the code 
segment,s in a 68K latgel and the files lliat they contain. 'ITits 
page works like the CodeWanior 1.x project window. The link 
Order page lisLs all the files in PowerPC target in the order dial 
die files will be linked into yuLir program, iliis list is flat since 
l^owerPC executables are not scgmcnicd. 

Alst> mw Ls dial it's now possible to drag things out of the 
project window. Filers dragged out of die projett tun lie dropped 
into all sorts of cool places. You can drop files onto applications 
in die Finder, you atu drop files into the trash to remove them 
from the project, you can select a group of files and drop them 
into the multi-file search list in the Find dialog, or you tan drag 
files fnim one project and drop them into another. ® 
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PLUCCIMC IN 



by Alan Weissman, TopSoft, Inc. 


Filter It! 


Join the Plug-in Revolution: 
Write a FiUerTop Filter 


ThF Pl UG-lN RliVOLimON 

Tn 1992 ^ fruitfijl coUaboralion began 
among a group of Mac programmers on 
Usenet. Fireci up by the idea of pooling 
their expertise to develop a kQler app that 
would incorporate many the new 
features of System 7, the,sc enthusiasts soon 
formally oiganized as TopSoft, inc., and 
dubbed tlictr chief project FilterTop. Its 
main purpose: to bring batch processing 
and pipelining from UNix to the Mac, using 
such advanced features as Apple evenLs, 
drag-and-drop and multithreading. 

Four years passed lx:fore FiltefTop's 
first full public release. A lot happened in 
that lime. Popular programs had evolved 
into resource-hungry monsters that had to 
incorpfjrate every conceivable feaiune^ and 
thi.s tendency was stifling lioth programmen> 
and users. To let in fresh air, a contrary trend 
in Mac programming was emerging, towanl 
modularity and plug-in architecture. We sec‘ 
this trend gaming momentum loday as large 
applications increasingly rely on small, 
interchangeable plug-ins to provide much of 
their functionality. Adobe Phouxshop is die 
best-known of these, but others are rapidly 
following .suit. 


Well, FilterTop was ahead of the pack, and today, in an age 
when software bloat and creeping fcaturitis still dominate, 
FilterTop seems more innovative dian ever, in faa, practically 
speaking, FilterTop is just a framework for plug-in modules, 

FilterTop offers a distinct advantage in die way it uses plug¬ 
ins. Each module, or filter, c^ be linked with others in a 
pipeline. Then one or a batch of files can he seni down the pipe, 
with each filler manipulating the files in a specified way. Instead 
of one filler at a time operating on one file, you have many filters 
operating in quick succession on many files, each of which might 
have been aeaicd by a different application. The FilterTop 
framework provides the user interface and the glue that ensures 
everything — batches of files and assemblages of filters — works 
together smiKithly, 

FilterTop shares an exciting property with other applications 
dial liave a plug-in architecture: extensibility. A new capability may 
be added to those already present simply by writing a new filter 
and plugging it in. The filter programmer doesnt have to know a 
thing alxiui die inner workings of FilterTop. Even preexi.siing fillers 
provide a field for experimentation. Diftereni peniiuiations and 
combinaiioas may provide new functionaliiy uj meet specific needs 
without your writing one udditiona! line of code. 

Best of all is that filters are easy to write. Most of the 
remainder of thLs ardelc will oudine the simple steps to create your 
own FilterTop filter. First, let’s get a general overview of FilterTtip's 
operation from the aser'.s point of view so you can form a Ix^tter 
idea of how a filter fils into the functioning of the whole. 

Fu.1 liKTop m Action 

The building bkx:ks of FilterTop are filters. The user can use just 
one at a lime or pipe together two or more. In all cases, however, 
they must be combined and set up by means of SuperFiiieni. Thc^c 
in turn may be saved in Files called Tophts, stand alone applets that 
pertbnn multiple operations on files — not by diemseives, but by 
using Apple events to pass instmtiioas U) FilteiTop. 


Alan Weissman believes that the tinkering of lvobi>yists is as important as the effort of professional developers in 
keeping the Mac an exciting platform. When not doing his own tinkering, he may be found working in Macintosh tech 
support, reading detective novels or listening to old jazz recordings, among multitudinous other activities. He may be 
reached ai alanw@bway.net. 
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A FikerTop ‘Foplet is somewhat analogous U> an AppleScript 
droplet; yoLi dn>p onto its icon in the Finder other icons 
representing any number of files (or you am just double-click it 
and add files later). A 'loplet is opened, causing a SuperFilter to 
l^e recreated according u> choices previously made by the user. 
Filter'lbp is launched if it is not already running and sent the 
infi>rmation that enables it to display icons for tlie files to be 
processc‘d and for filters that represent the operations to t>e 
performed on the files. If the toption to do so has been chosen, 
the files are automatically processed-, rKherwise, FilrerTop waits 
for the processing to be initiated by the user. 

lb aeate a SuperFilter in ihc first place, you drag icons from a 
list (displayed in a flcrating palette) to a window. Eac h filter lias one 
or more fx>rfs, indic^ued on tlie top and bottom of tiie icon. You use 
the mouse to connect the filters in custom order liy dragging from 
one pcirr to another When tills Is done, the filters are shown 
connected by pictureii of pipes. Ibus the concc 7 )l of pifx:lining — 
an abstraa one in of^-rating systeras widiout a GUI — is grapiiiadly 
illustrated on tlie Mac. In faci, m\li its menus, lists, windows and 
icons, Filtcri'op is very much a Macintosh appliaition. 
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Figure L A SuiK^rFilter wf up £wJ recuiy to run. 


lcon.s for files to be prcK’essed appear in another part of the 
window, Figure 1 shows an example. Say you have a group of 
twenty files. Facii is a SimiilcTexi file an<l contains a section of 
an article. The files are named ‘'Part 01,” “Part 02," etc. Your 
objeci is to tTcate a single plain-text file that contains the entire 
article and will ojk-ii in MicTosoft Worti. By dragging and 
dropping with the mouse, you cre-alc a pipeline of several filters 
in the Su|KTFilter editor window. Tlie first a.ssure.s iltai fhe files 
are .soned by their names; the next concatenates die text of all 
the files; the next changes the LTcator txHle of the tmtput fde to 
tliat of Word; the next assigns a name to tlie output file; and the 
final filter sends the result to a folder you have designated. 

You click a button and wiine.ss the start of prcx:essing; the 
filter icons Ixtcome dark as data Hows through them, the pipes 
swell when the data flows down to the next filter, and so on. At 


least that is the GUI representation of what i.s going on behind 
the scenes, Bruce liennett, an amased commentator on the 
Internet, called Filteffop "UNIX batch processing by Rube 
Goldberg." That is tlie way it Icxiks, (It also shows that nieml:>ers 
of the Mac community have a sense of humor!) Though FilterTop 
may appear to he an ungainly contraption that you watch willi a 
smile, it works, and with surprising speed and efficiency. 

Adva^ntaoes of Writing a Fd.ter 

Writing a filter to perform a given function is easier by an 
order of magnitude than creating a stand-alone application. 
FilterTop handles the tough saiff. It coordinates the operations of 
the various filters and assembles the files passed to it by the user. 
It pas.ses to your filter the data to be pRx^essed. It aliow^s you to 
retrieve the user’s preferences as w'cil as a certain amount of data 
to l>e used in fK^rfonning the operation, such as a siring to Ix^ 
searched for. When you are ihroiigh procressing — TUtering" — 
the daia, the Filteffop engine receives the re.solis, which ir passes 
on U) the next filler or .saves to disk as a file. 

Tiius, you die filter programmer need lie coneemed only with 
the specific task you want your filter to accomplish, 'fliis may be 
simple, such as (ounting the characters in an injiut file, cjr much 
more advanced, sucfi as applying a .sophlstictited compression 
algorithm or translating from one graphics format to anodier. 
Pujfessional developers can find intriguing jxitenUal in FilterTop 
filters, yet programming one i.s simple enough for hol>byLsis. 

WmnNG Your Fii.Tr.R 


Getting Started 

For your filter to work properly you are required to follow 
a stria set of guidelines. Tills may seem ci>nsirainmg at first but 
litis system has its advantages. First of all, FilterTop provides 
firognimmers with numerous aids to lielp you comply with its 
restrictions and get your code working. Sec'ondly, once you set 
iifi everything correctly for interaction witli tlie FilterTop engine, 
you are left with a great deal of latitude in what you can do in 
the fxKly of your code. In addition, you will find that, once you 
are tromlbnahlc using the framework FilterTop provides, you are 
frwU from the need to spend lime on the details of pre- and 
po.st-pr(xe,ssing, including handling mo.st of the user interface 
and all but the .simple.st aspects of error lni[)[)ing and reporting. 

The Basic Steps 

Here are the five ba.sic sLep.s to create a fully Funaioning 
FilterTop filler: 

• Receive mes.sages from the engine. 

• Retrieve data from the engine. 

• Pnxess the data. 

• Return the results to the engine. 

• Send a rcium code back lo the engine indictuing the outcome 
of the operation. 

There are also a few things to be done with re.stiurces at 
different stages. At this Lime .stipport is provided for writing filters 
in “C," using either Metrowerks CcxleWarrior or 'fHljSlK C. 
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AcldiLional support may bt: added iii the futufe* (it should also l^e 
mentioned that hllterTop is not currently PPC native; this will 
probably change with the next major revision.) 

Receive Messages 

To receive messages from FilterTop, ytni must #inc]ud6 
"FTFilter.h", a header hie that defines diese messages. FTFilter.h, 
supplied by TopSoft with iLs other programming uk)1s, also 
defines the data stnjciurL's and functions that FtiierTtjp uses and 
with which you must become familiar. 

In fach messages and everytliiiig else transmitted to you by 
FiiterTop come through a [}arameter block, a pointer to which is 
passed to your hlicrs mainO function when its code is executed. 
In this respect as well as in others, as we'll .see, a FiiterTop filler 
resembles a HypeiTlard XCMD. If you have any familiarity with 
the latter you can easily understand the former. (Photoshop filters 
work in the same geneml way; if you can write one of tht)se, a 
FiiterTop filler is a cinch.) The structure of this parameter block 
Is worth studying; once you get the hang of how it wt>rks you 
will have gone a g(XK.l way towartl <x>mpreheriding the interface 
between your own eexJe and FiiterTop. 

typtrdcr sTruct 
I 


FliterMtfHsagQ 

6f*rviceftequested: 

// esscntltl 

long 

fit terShellVscsion: 

// ignore 

Callbacks 

'cb: 

// esseritUl 

DlalogPtr 

dig; 

'event: 

// rarely used 

EvGnt.Rftcord 

// rardy uscti 

Handle 

liiterClobalsH: 

// useful 


filterConfigli: 

// rarely used 

long 

data; 

// useful 

FBCallToFllt4?r. 

^PBCsUToFilterFtr: 



Understanding the FiiterTop ]>arameter block is easier than 
it at first appears, betrause it is essential to deal with only two of 
its elements. Two others are also useful at Limes, and the rest are 
either reserved by Filter Fop or used only with certain special 
types of filters. filterShellVersion is reserved l)y FiiterTop. 
tilterConfigH, dig and ’event are used in filters only if the filters 
must interact with the user thrtnigh their owti sell-created dialog. 
Tills is rarely if ever net:essary since Filter Ibp also provides a 
remarkably complete means of putting up sudi a dialog and 
retrieving preferences automatically, through a mechanism called 
AuioConfig. More about AuioConfig later. 

All filters are rtvnirant\ that is, if a filter has l>een called, it 
may he called a second lime (and a third, etc,) before the first 
instance returns. This imprises die restriction diat filters may not 
have global variables (otherwise, more than one instance of a 
filler could struggle over the globals). It Is fiermissible, however, 
for memory allocated on the heap to be used as though it were 
global, and the memIxT filterGlobalsFI is provided as a convenient 
way of acces,sing a block of these ^globals.'’ The member data Is 
similar to die refCon provided in Toolbox window and control 
records. Basically, you can put any four^byte value you want 
there for t:onvenieni later retrieval. 

Tlic absolutely essential mcnil>ers of the parameter l>kx'k, 
liDwever, are the First and die third. (We will eome buck to the 
third a Uule later onj serviceHequested is a variable that you must 


High Performance 
Imaging and Annotation 
Development Tools 

RasIcrMaster 6.0 - Familiar API and welFprovan technology in use 
world-wide by companies such as British Petroleum, Chase Manhat¬ 
tan, Eastman Kodak. Filenet Ford, Gannett, Hewlett-Packard, IMSI. 
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50+ Raster Formats All TIFF, JPEG, Groups, Group4. MO OCA 
lOCA, CALS. PNG, PCX, BMP, GIF. PhotoCD, ABIC, Flashpix and more' 

RasterNote^annolalion/redlining toolkit - Includes all popular features 
Create Sticky Notes, Freehand Drawing, Lines, Ellipses, Polygons 

NEW ADDITIONS: RasterNote, UNIX, Alpha, Flashpix 

Format Reading, Saving, Compression. Display, Despeckle 
Rotate, Zoom, Pan, Scroil, Deskew, Anti aliased display. 

Auto aspect ratio, image proc^sstrtg, Transparent color 
Improved Twain scanning, COtor reduction and promotran 

Platforms: Win 95, Win NT, Win 3 1, OS/2, Alpha. Macintosh, UNIX 
Environments: DLL. VBX, cicX/ActiveX, Delphi, VB, PBuilder, VC ++ 

Call 617 630-9465 or soc our Wcljsile for FREE. NO RtSK EVALUATIDNSt 

WWW s uowtmd. com 

PO Box 520 Newton. MA 02159 Tel 617 630 9495 Fax 617 630-0210 
Email safe^cf^snowbnd com 

KmiwiMN^asm 

SOFVWAIIB... 

Sitfiwart' * /Viiwr/tf/. t 'mt, HeiietbU* 


examine iiiuncdiately whenever your filter is called, it is siandard 
pniclice simply to set up a switch .statemem to handle the 
messages in serviceRequested, and in most filtets the main 
function will consist of little more llian tliis switch .slatemc-nl. 

pascal FiltcrResult nainC PBCallToFliter *pb } 

I 

FilterResiilt rc; 

KNTEE_FILTER: 

Switr.h (pb->servieeRequo stpd) 

i 

case msgOpotiFilter: 

rc nitnrHagHotHandled: 
break; 

case msgFiltt'rHata: 

rc = MyFiUerFunctianf pb ); 
break: 

cane ms^CloseFllter: 

rc ^ filterMsgNotliarjdl od: 
break: 
defaul t: 

rc " fllierMngNotHandied: 

I 

EnT„FILTER(rc): 

I 

(ENTER_FILTER and EXIT^FILTER are maous that enable 
your filter to u.sc iJ^c A4 register to handle static dita ih^t the 
ctsmpiler treats as globals.) msgOpenFilter and msgCloseRlter are 
occasionally useful if you want to set up some structure or 
perform a particular action only tincc at tlic beginning of a 
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MkLinu^^ 

Microkernel Linux for the Power Macintosh \ 

Why wait for Rhapsody? Mkl ,inux is a complete system, 
based on Linux 2 and the Mach 3 microkernel It includes a 
complete software development system (gcc, gdb, perl,...), 
X11R6.3, and hundreds of other commands. Get NDcLinux 
and start working right now with Madi, Objective-C, UNIX 
development tools, and more,.. 

MkLinux builds and runs most Intel-based Linux software. 
It works efficiently and reliably on a wide range of Tower 
Macintosh platforms, with other ports on the way. Mkl inux 
has an active user community and a substantial Reference 
Release, both sponsored by Apple Computer- If you want to 
get a jump start on Rhapsody, this is a great way to do it! 

Visit Apple's MkLinux web site (www.mklinux.apple.com) 
and Prime Time Freeware's web site (www.ptf.com) to find 
out more about MkLinux and other fine freeware products. 

Prime Time Tree ware info@ptf.com 

370 Altair Way, #150 (408) 433^9662 

Sunnyvale, CA 94086 (408) 433-0727 fax 


riltraiion session and not every time diita is sent to your filler. 
'Ilierc are other messages that you must know for special types 
of filters. In most cases, liowever, the only message you must act 
on is msgFilterData, which simply is the go-ahead tliat signals you 
to perfomi the action that your filter is supjxjscti to perform. 

'Ihe variable rc, of type FilterResult, receives a return ccxle. 
Normally if will be filterOK. wlvich indiotes that your filter 
successfully did what it is supposed to do, or filterMsgNotHandled, 
as seen here (whicli simply tndtates that you take no action on 
tills particular message). On (K’casion you might also reium 
filterAborted. in case you were infonned by the engine that the 
user has aborted the filtration, or filterprocessing Error, to infomi 
tile engine (or confirm dial you have been inlbrmed) dial an 
unrecoverable processing error occurred. Either of these codes, 
or filterOK, miglit be assigned to rc through MyFilterFunction in the 
example above, depending on whai happened during filtraLion. 
That is ad you must know about the FiltcrTop message's. 

Retrieve the Data 

The second member of the FilcerTop pant meter bkx'k, ‘cb, 
is extremely importani. It is, simply, a pointer to another 
structure, this one consisting of (at this writing) twcniy-iwo 
pointers to functions. These functions are the FilterTop callhacki, 
a term that, again, you will be familiar wiili if you have written 
any HyperCard XCMDs. The callbacks are functions that 
FilterTop provides for interacting with it; the engine passes you 


pointers u> the callbacks, and you cal! hack to the engine by 
simply dereferencing one of the pointers, passing the parameters 
required by that particular routine* 

static FilterRcsult MyFllierFunctiOH( PBCallToFllter ‘pb ) 

r 

FTErr err* vrlteSrc: 

Stream inpiLtStream, cutputStream; 

FInfn fndrlnfo; 

FSSpec suggested^Epec; 


err “ pb->cb'>Open(lnputl, 
IlANDLE„ERR(err); 


&iEipiLtStte&Di. &fndrinfo, 
^suggested spec); 


Note the doulile use of the pointer-to-memlKT operator to call 
Open* a pointer to which is passed as pan of cb, ilie Callbacks 
*struciurc\ which in turn is ixjinied to by pb. the parametcT-bUxk 
pointer. Tlie Open i:allhack will become very familiar to you, as it 
Ls used to open both input and output streams, 

FilterTop is l^iuli around liic mt>dcl of streams. This concept 
should lx familiar to anyone who programs in C. Streams, which 
are simply sequences of bytes, interpose a layer of abstraction 
Ixiween your filter and ilx files input to it. Instead of handling 
the details of file I/O, you simply o/xfi, neW from, wriie to and 
claw streams. 

After opening an input .stream, we must open an output stream: 


err * pb->cb->0pen{ outputl* faoutputStreain* &fndrtnrD. 


&8Ugg«flted„f3pec ); 
HAHDLE_ERR[errJ; 


inputi and outputi are constants repre.senting pipes from 
which to read, or to which to write, the stream in question. 
fitinputStream and &outpytStream are* pointers to varialilcs of type 
Stream; the FiUer3c>p engine siore.s in these variables stream 
identifiers that you need to pass back to it whenever you acceSsS 
the streams, Tlic next two parameters similarly retreive Finder 
information (FInfo) and a file-specifiaition record (FSSpec) 
associated with the stream. Usually tliese have lieen derived from 
a file on disk that was the origin of the strettm. But sint:e streams 
do not necessarily cDrrCHfK>nd to files on disk (they may have 
lx*cn created in a previous filter, fc^r example), this information 
should not Ix^ considered as necessarily bound to a file. It is 
there so that if needed the engine can use it to create a new file 
on tii.sk at the end of tile filtration prexess* In most cases, you 
just pass along what ycxi receive, although .specialfaed filters may 
alter this information. 

HANDLE_ERR is a macro Uiai represents a simple error- 
handling mechanism, defined as: 


fdefine HANDLE^ER!l( (jri: ) if( err !- ft OK U \ 

err 3= ftEndOfData ) \ 

if{ err =- ftAbort ) \ 

return filtetAborted: \ 

else V 


return flJlterFroceEsingError: 
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Process the Data 

Now you are ready to have your filter perforin its filtration. 

#define BUfSIZE 102^ 

long bufslze - BIFFSIZE: 

Char buircrLBUFSIZE] ; 

whilst ecr 1= fLEndOfData ) 

err = pb->cb->Rsaat InputStrsara. buffer* fitbufsize )r 
HANDLE_ERlt{ err ); 


Use Read to obtain a convenient nttmber of bytes from the 
input stream into a buffer dial you have set up. This buffer may 
hold anywhere from a single byte to several megal>yies. Tlie 
latter is an extreme case. If you want to create a large buffer, you 
can allocate memory on PflierTop’s heap. This may be necessary 
with certain kinds of filters. But whenever possible use a small 
buffer on the stack and process your data in small chunks, 
writing the proce.ssed data to the output stream as you go. Thi.s 
enables the daui to be passed to the next filter immediately for 
efficient pipelining. Also remember that available memory must 
be shared among all currently operating filters* and there may be 
quite a few of them. FilterTop is multithreaded, and several 
threads may be active at tire same time. 

/♦ 

Our fitter peifonus n very simple operation: eonvening all plain lowcncase characters 
to uppeaase: we loop until all eliaracters in the input stream have been read, checked 
converted if ncccssaiy and written to the output stream. 

V 

long 1: 

foir{ i = 0; 1 < bitfsise; ++i ) 

{ 

if{ buffer [i] >= 'a' buffer |i] <- 'z* ) 
buffer[ij ’= 32: 

I 

if( buffilze > 0 ) 

writeErr “ pb->cb‘>Write(oatputStream* buffer* bufsiza ): 
IiANDL£_ERRt writeErr }; 

I 

I //end while ( err != ftEndOfEata ) 

Wlien the Read callback returns the code ftEndOfData, that 
is the signal to end ilie while loop, as all the bytes tiave been 
read fK>m the input stream, llie FInfo and FSSpec were already 
copied to the output stream when it was opened. ITiere remain 
only die resource.^ associated with the stream to be copied to the 
output stream. 

err = pb->cb->CopyResources( jLnputStream, outputStroam ): 
liAKDLE_£RR( err ); 

CopyResources simply copies all the resources at once, and very 
quickly; if there are no resources it does nothing, so it can’t hurt 
to use this callback if you are not sure atx)ut the resource forks 
of die files you are Mtering. FilterTop also provides callbacks for 
copying individual resources if you should want to do so. 


Guess which 
installer 
was built by 
Draginstall. 




Guess again. 

If you guessed that the first installer was 
built by Draginstall, you’re only half right. 
Now with Draginstall 3.0, you can build both 
of tliese installers from a single script file! 

For more information about Draginstall 
and a free demo, visit our web site at 

http://www.sauers.com/draginstall 

or give us a call at 1-800-890-9880. 
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Return Your Rcj^ufts 

Now we clase tx>L[i the input stream and the output strcatri: 

err “ pb->cb->CloRe( inpuLStrsam ); 

HANDLE ERR( err ); 

err “ pb->cb >Clt)Be( outputStream ); 

HAND1,E_ERR( err )t 

Notice rhai we always check for errors. Tliis not only allows 
us to returri control gnicehilly to the FilterTop engine in case a 
serious error has Irecn detected (wltitrh we can do also if we 
encountered sttch an enor in our own code; FilterTop offers yet 
other, more .stjpfiisLic:ated means of error reporting that you should 
look into), it also gives you a way to find out if' the user has decided 
to alx)n the operation. If the engine leturns the axle ftAbort from 
any uf iLs c:allbacks, that is the signal to clean up and immediately 
return control to FilterTop. With a simple filter like this one, die 
macro HANDLE^ERR is all you need if yoii neceive thus message. 
All it doe.s Ls return control to FilterTop (with the appropriate return 
ccxle), and that is suffic lent. (Though just baiely. Unles.s your filler 
Is of the simplest kind, you should consider using tlie ReportError 
calllrack before returning filterProcessIngError, There: you can pa.s.s a 
mefssage siring lo ihe engine indicating tlie tyfx.- of error that 
occurred ll^e engine then displays this message to tile u.sen) More 
complicated filters may perfonii one or two cleaniif) operations. If 
any memory was allocated on the heap, it should be disposed of. 
In most cases, tliat is all yon must worry about. 

Send a Return Code 

And, finally, since if wc have reached this point all has gone 
satisfactorily, return Lo FilterTop (through our main function) 
Willi ihe axle filterOK. 

return fiiterOK; 
f 

Always remember to return a return cxxle whenever you 
hand control Ixick lo FilterTop. If you are resf>ondlng lo close 
messages, you also mu si clc^an up w-hen you receive one. You 
might, for example, liave allocated some cfuasi-global memoiy 
when you were opened: naturally, you must free this when told 
to close. 1’he FilterTop parameter block include.s the field 
filterGlobalsH os a convenient way of holding anti managing a 
handle to a block on the heap; it does not have to lioid “globals" 
but can be used any way you want. 

AutoCoiifig 

Now' (continuing with our example) suppose you decide 
that the user should hav^e the oi>tion of deciding whether to 
convert uppert:ase to lowercase text or die reverse. You want to 
display a dialog box giving the user the option to check 
^‘llpfiercase to Lowerca.se." In a full-soale appHcadon this is 
relatively simple. Even so, you have to deal with setting up the 
dialog and trapping events to find out w^hat the user did in the 
dialog. You could instead add a menu item, but here you are a 
sUtnd-alone exxie module, and, running in the context of 
FilteiTbp, you cannot provide your own menu item or even t rap 
events, or you miglit interfere with FilterTop’s own operation. 


Not lo wony. FilterTop provides you, the filter programmer, 
w'ith all the machinery to retrieve user preferences without 
having to be concerned aixiut displaying dialogs (except in 
Ke.sEdit), creating menu ftems, or handling a single event. This 
machinery is called AuloConfig. With AutoConfig* instead of 
devoting twenty^-five percent of your cixle to creating and 
dispo.sing of dialogs and managing event loops, you can handle 
tlie w hole business of Filter configuration and interaaing witli the 
user by a few minutes' w^ork with ResFdit or another resource 
editor, and just a few extra lines of code. 

'I he I‘ilteiTop developers' kit provide.s ResEdit templates for 
the TWO special re.sources required, fCFCF and dVli)\ In 
addition, you must create one each of die usual d:)LOG' and 
‘UITL' resources. FilterTop expects all these resources to have the 
ID of 128. There are three .standard items that your dkilog must 
liave to be consistent with all fdter-configuration dialog boxes. 
These are tiic diree buttons that the user clicks to '"Use Now" (tfie 
default, always item 1), “Gance!" (item 2) or “Make Default” (item 
3), which tells FiitetTbp to save the current configuration as the 
default setup whenever this filter is used. 


□ Uppercase to Lomercase 
[ Cancel ] [ Hake Oefault ] [use Nolo] 

__ I _ I _L -.1. - ' ^ 

Figure 2. The AutoConjtg dialog seen in ResEdit^ 

We will add a single Item of our own: a checkliox (item 4) 
witli the text ''Up|x^roasc‘ to Lowercra.se". (Figure 2 shows die 
result of setting up the 'DLOG’ and ‘DlTl.' resources.) By 
convention FilterTop pa.sses on to the filter code die Boolean value 
of a checkbox with a single character {not the actual number), T' 
hir “tnie" and 'O' for “false.” This result is linked with the kiterrutl 
name of the item. Tliis name (which has notliing lo do witfi the 
name of any resoLircc) is a,s.signetl by you in the fCFG' resource 
(Figure 3) and must be a four-cltameter name of type OSType — 
the same kind of name used for resource types, FiJc Lyix:s ancJ 
creator codes, among odier things. We will assign the name 'UtoL'. 
A default value am lie supplied, wfiich we will make *0L (We don't 
actually use the single quotation marks in die re.sourcc.) 



Figui*e 1 The fCFG' resource. 
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I'he values in one more resourc:e must lx* filled m lo sei up 
our AuioConfig dialog: those in die ‘fVLD' resource (Figure 4), 
Tliere are several fields la lx completed in the template. Values 
such as “Group/' “Class," etc., may be ased lo link dialog items 
in t'omplex ways. Also, for dialtJgs with edit-text items, minimum 
and iiKiximuni values and lengtlis, as well as a set of valid 
characters, may lx provided, All these options are explained in 
the filter prtjgraiiimer’s documentation. For our simple example, 
a.s for all simple checktoxes unlinked to others, wc can enter 
cither zero or nothing at all in all the fiekls. Also be sure to enter 
the number of ilte dialog item. (Do noi create items in the fVLD' 
res(>urce for the three retjuired button items 1 to 3; dicse are 
iiandled automatic:ally.) 


i fUlQ ID » ! 28 from [ 


nunSane 1 

Qlulcg Iten 
f(un 

I ten Class 
Group 
ninLenglh 
HOXLength 
Ual IdSM 
UpperUalue 
LonorUalue 

2) *Jt!#** 


G 


G 

0 

1 





Want to suggest an article for the 
magazine? Send your suggestion to 
<mailto:editorial@niactech.com> 


Figure 4 'Ihe fyjj}' resource. 

Tliis done, mexiifying our code to retrieve the iLser’s 
configuration preference requires just a few lines, as follows: 

char configChar; 

long conflgLen " slzeofC char 

art “ pb*>cb->CfgFtndD9ta(‘UtoL‘. iconflgtlhar. iconflgLen); 
HANDtE ERR(err); 
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Then wc in<xli(y our loop to extend our functionality based on 
the additional preference: 

if( configChar = ’1" ) //Uppcrcscic to lowercase 
I 

for( 1 » Oj 1 < biifsize; ++1 ) 

I 

if{ buffer[ij >“ VA' && buffer[i] <“ 'Z’ ) 
buffer [1] 32: 

] 

else // Lowercase to uppercase 
( 

for( i “ 0: i < bufsize; +fl ) 
t 

if( bufferlij >= hh buffer[i] <= *i* ) 
bufferUl ^=32: 

I 

1 

All this takes longer to explain than to do! (Nme: There already 
exists a “Change Case" filter, written several years ago by TopSoft^s 
founder, Stephen Jovanovic. My example code is slightly different 
for demonstration purpases but does pafty much the same thing.) 

The ‘fINF resource 

At tills point we almost have a ftiUy functioning filter. We need 
only to register some information with FilierTop so it will know 
liow many ports we have and what names should lx: attached to 
thenc and a few other items. This Is done in the 'flNF' resource 
(again, ID 128), which must be part of ail FilterTnp filters. 


rWF II ^ Ul from MK Filter.tf.nit: 
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Figure 5. 7he 'JlNF" resource. 


Let’s quickly run through the 'EDSIF items. {See Figure 5-) Ttie 
item '‘Filter Version" Is your own threeniigit numlxfr. There is an 
imaginaiy^ decimal point Ixrtwcen the first and second digics. “Min 
FilterTop Veision" at this time should just be “liX)." In the future tliere 
conceivably could be filters that will mn witli FilterTop version 2.0 
but not earlier, for exampke “Cur FilterTop Version" is also now 
“100,” but will naturally change. “Slack Memory Requiied" must be 
filled in only if you determine tktt you will need an unusual amount 
of stack space. In mast cases just leave this at “0" for the default. (It 
can't huit to put in an estimate; future venjions of FilterTop may 
require one.) “Config Passible" should be true if you use AutoCbtifig 
or are self-configuring and false if not. (“Selfcronfigufation” is an 


option that admittedly has not been w^ell supported; this is 
understandable, however, since AutoQinfig has so far provickxl for 
all configuration neetls anybody has had.) "C^mfig Required" is not 
ainendy supported. Set this to false. “AutoConfig" is self-explanatory. 
“Uses F.iror Fort": FilterTop f>rovides the option of having a special 
output port for reporting of noiy-fataJ errors — .set This to true if you 
use this option. “Filter Name," ‘‘Author,” “Copyright’ and 
“DescTiption" are all self-explanatory. There should, finally, be an 
input field for each of your inputs (currently only one is supported) 
and an output field for each output. What comes in and wliat goes 
out of these ports should also lx; briefly descnlxxl. 

Now, with tliese resources in your projects resource file, you 
are ready to compile your filter. Compile it as a “Code Resource” 
with a resource type of ’FILT and ID of 128. Assign the resulting 
resourtre file a rype code of ‘FILT and creator code of 'fTOP'. 
Depending on your crxle and your development environment, 
you may have to include one or more libraries in ytiur project. 
Check the documentation if necessary. 

Tliat's id You now^ have a FilterTop filter tliat will be fully 
recognized by FilterTop, can be added to any pipeline and will 
work liarmoniously wiili all of the existing filters. Just drag it into 
tlie appropriate subfolder in die “Fillers” folder. Again, all of the 
alx)ve .steps take longer to descrilie than to do. With practice, all 
of this will become second naRire as you build up a collection of 
useful filters, each easy to w'rite heouse FilteiTop handles all of 
the drutlgery for you. Now you can devote all of your creativity to 
that translation or encryption utility (or wkitcver) that you’ve been 
hankering to write. Feel free to submit your work to TopSofi. It 
may just be added (w'ith your penni.ssion of course) to the growing 
collection of free filters available at the TopSoft FTP site. 

'File FiIterTt)p area of the lbpik:>ft FTP site is Itx^ied at 
<ftp.topsoft.org/Visitor 5 /filterTop/>. There you will find the complete 
FilterTop application (ids free!) a,s well as various filters not 
included in the main package. Also of .special interest are the 
archive of filter source code (see what others have done) and the 
Filler Writer’s Guide, which provides much more information 
about writing fillers than I have been able to give here, including 
guidelines for creating your owm cy.stom icons for your fiiters and 
for writing filters that have more specialized requirements than 
our simple example. You can also easily create help da:uments 
that are modular like filters and are automatically added to 
FilterTop\s elaborate About box. Also check out the Web site at 
<http://www.topsoft.or 9 >. Information about anything you can’t find 
at the FIT or Web site may be obtained directly from Tony 
Jactjbs, the President of TopSoft, at <tnfo@topsoft.org>. 

Join tile p!ug-in revolution now! 
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Programming With QuickTime VR 


A look at the new API for 
managing QuickTime 
VR movies 

iNTRoDiKrrnm 

QlikkTimc VR is the part of the 
QuickTime Media Layer that allows users 
to interactively explore and examine 
photorealistic, three-dimensional virtual 
worlds and o[>jects. For several years, 
MacOS and Windows users have Ijecn able 
to play back QuickTime VR content using 
standard navigation controls. With version 
2.0, QuickTime VR now supporDi a C API 
tliat allows developers to customize and 
extend the user’s virtual experience. Here 
you'll find cvcrytliing you need to know to 
get started supporting QuickTime VR in 
your application. 

QuickTime VR is certainly one of the 
hottest Apple technologies today. Dozens 
and dozens of CD titles Ivave appeared in 
the past montlLs that depend on QuickTime 
VR, More significantly, the World Wide Web 
now serves up literally thousands of 
QuickTime VR movies, A large part of this 
popularity stems from the faa that die 
amount of data required to display a 
complex, photorealistic panorama using 
QuickTime VR is much smaller than would 
be required to mtxlel lliat panorama in 
detail using a standard 3D graphics 


application. 'ITiis, logcdicr witli die fact that no run-time rendering 
is tKcurring, drastically leduces the aniounl of CPU horsepower 
and RAM required to immerse the user in a realistic 3D 
environment, QuickTime VR can transport the user from Llic 
tightest passagew'ay deep inside the pyramids to die wide-open 
expaasc of the space shuttle payload l)ay. 

But, to paraphrase Ai JoLson, you ain’t seen nothin' yet, 
folks. Apple has ret:enlly introduced a C language programming 
interface to QuickTime VR — called the QuickTime VR Manager 
— dial provides a large .set of itKds for extending and 
customizing the user’s virtual experience, 'the QiiitikTime VR 
Manager provides die neceasary hcxiks tor you to add your own 
custom prtKCSSirig to VR movie playliack and to integrate 
QuickTime VR content playliack with other technologies, 
pardcularly with odier multimedia technologies. F«jr instance, 
you c:an very easily integrate Apple’s SoundSprocket with 
QuickTime VR to attach sounds to specific locations in a 
panorama. Or, you can play QuickTime movies on the screen of 
a televi.sion in a panorama. Or, you can embed QuickDraw 3D 
objecLs (even moving ohjeas!) in a panorama or objea node. 
Take your favorite technology and, chances are, there’s a cool 
way to integrate it with a VR panorama or object. 

In this article, well explain Mime basic ways of using the 
QuickTime VR Manager in your application. We start by reviewing 
some simple but important aspects of QuickTime movie support. 
Then we move into programmatic control of QuickTime VR 
movies by showing how to use standard Movie Tfxdbox and 
movie controller functions to operate on QuickTime VR movies. 
Finally, we’U describe the QuickTime VR Manager itself and 
present some code that demonstrates a few of its capabilities. 

Before reading diLs article, you should lx.* familiar with the 
basic capabilities and operations t)f QuickTime VR, At the very 
least, you should have opened some panoramas or object 


Tim Monroe <monrioe@apple.com> is a software engineer on the QuickTime VR team. resptMisihle for developing sample 
code for the mw Quickl ime VR C language APL In his previous life at Apple, he worked on the Inside Macintosh team. 

Bryce Wolfson <bwolfson©apple.com> is also a software engineer with Apple's QuickTime VR team. He's responsibie for 
parts of tlie QIVR runlime’s architecture, human imcrface, and application interaction, and has been known to occasionally 
write bits of over-commented sample code. 
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movies using a QuickTime player (for inMance, MoviePlayer or 
QTVTiPlayer) and have a good understanding of the V\{ user 
interface (f)anning and lilting, zooming in and out, iiiggeriiig hot 
spots, and so foitli). You can also gei the necessary background 
information by kxrking at the first dozen pages of the Ixxjk 
Virtual Rmlity Prof^rarnmin^ With QuickTime VR 2.0, tlie 
developer dixumeniation for the QuickTime VU Manager. 

Back To Basics 

Tile first thing lo keep in mind is that Quickl ime VR movies 
are just Quicklime movies, at least in the way the movie tiata is 
sltJiTcd in files. The image data for panoramas and objects is storetl 
in standard QuickTime video rracks in movie tiles. Other data (such 
as names of die nodes in a .scene) is stored in data atoms in the 
movie resources. What's different about QuickTime Vli is the way 
in wliidi the image tiara Is handled. In a QuickTime movie, frames 
of a movie are read from a videtj track and displayed in sequence 
to the user In a QuickTime VR movie, tlie image handling is more 
complicaied, because the image to be displayed dejxintls more 
heavily on user inLerat:iion. in an ob)ea movie, for in.stance, die user 
am pan left or tight, tilt up or down, or zoom in and out (among 
other things), these actions tyi^ically require a new frame from tlie 
movie's vidc^) track to be displayed. The new frame, however, may 
or may not follow die ctirrent frame in the movie’s video track. 

Displaying tile appropriate panorama or object images in 
respon.se to user actions is the res|xjnsibility of the QuickTime W 
movie conirollcT, wliich is a .standard QuickTime movie controller, 
hvery QuickTime VR movie contains a special piece of user data diat 
identifies the movie coniroller for the movie. Tills user data is 
examinoJ by the Movie I'cxjlbox when an appliaiiion calls the 
NewMovieCfontRjlk-r funtiion to craire a movie ointroller for tlie 
movie, if die QuickTime VR extension is insialled and tlie Quicklime 
VR movie coniroller component is tlieiefore availabJc, the Movie 
Toollxix locaic-s dial controller and assigns it to that movie. 

Now here's die payoff: if yiJuVe done things right, your 
QuickTime application already suppotls QuickTime V7?.^ Cit> ahead 
and try it: launch ytmr Quick l‘ime-sa\wy applicxtion, select Open 
from the File menu, and dien chixise a Quicklime VR movie. 
(rosier .still, jusi: drag the VR movie icon onto your application s 
icon.) If everything goes according to plan, the movie will 
open correedy and you’ll Ix^ able to navigate within the panorama 
or manipulate the object in all the right ways. This is because, as 
we've ju.st .said, the Quick rime VR file contain.s information dial 
specifies the QuickTime VR movie controlicT instead of a 
Quic kTime movie controller. It couldn't lie any eiisier. 

Tills payoff, however, has a catch: to gel VR movie playback, 
you have to suj)|X5rt QuickTime in the right way. Part of wliat thal 
means is that you have lo call NewMovieControllt^r to a.ssociate a 
movie controller with a movie. Years ago, Peter Hoddie voicetl this 
warning in a develop column: “When you need a user iiiteriace for 
playing a movie, you should u,se NewMovieControlicT to create a 
movie controller appropriate for use with tliat movie. A common 
mistake is to instead use the Component Manager routine 
FindNextComponeni or Open Default Component to locate a movie 
controller, lliis finds the first movie controller in the system's list 


of registered cx^m[x>nenls, QuickTime has always contained only 
one movie controller, st) this worked fine. However, fumre 
versions of Quicklime will almost certainly inciude other movie 
contmllers, .so the Hrst one isriT necessarily the most appropriate 
one." (Ikxidie, p. 22) 

These "future versions" of QuickTime arc' lierc* now, and 
one of diem i.s Qukk'fime VR, So, to support VR movies, you 
must call New MovieCon I roller instead of the Component 
Manager. More generally, you slxiuld make sure that youVe 
h>llowed all the advice in floddie's important article. It won't 
take you long to do .so, and it will make it easier to support 
QHiickTime in all its manifestations. 

Bfyqnd the Basics 

Once you've implemented basic — and correct — 
QuickTime movie playlxick supjxirt in your apfilication, there are 
stii! a few other things you should do to handle QuickTime VR 
movies. In particular, you'll want to enable and disable menu 
items correctly and to display the correci cursor when it’s outside 
the movie window. Happily, you can do each of these diings wjtli 
jList a few line.s of c:<xle. We’a" .supposing thaxighoul that you 
want your application to liantlle Ixith QuickTime and Quick! ime 
VR movies; if instead you wanted to build just a QuickTime VR 
pluyen some of these steps (for instance, worrying alxiul die 
Select All menu command) wouldn't be necessary, 

'Ihe first thing you'll want to do is support the standard movie 
editing commands for QuickTime movies but also disable any Edit 
menu items that don't make .sense for QuickTime VR movies. When 
you fii'st open a QuickTime or QuickTime VR movie, you can call 
MCEnableKditing to turn on editing (which by default is off): 

M GEna b 1 e Ed i t in r (myRC. true): // cnahk movie conTnollcr cttiTing 

ITere myMC is the movie crmiroller. Well keep track of this 
and other information by setting fields in a window object record, 
a d;ua structure assoc iated with each window^ that contains a 
QuickTime or QuickTime VR movie; see laltT on in this article for 
the exact stnicture of a window object record. 

As recommended in Hoddie‘s article, we use the 
MCStTllpEditMenu function in our menu-adjusting routine to 
enable and disable items in the Edit menu: 

raywe “ { "jnytfindovOb jtct] ,fCoritroller; 

if (flyyHC J= mil) 

MCSetUpEditMenutmyMG. OL, GctMH^^ndl (TraBdi t)); 

The QuickTime VR movie c:ontroller disables most of the 
Edit menu items, since they don't apply to ’VR movies. It does 
not however disable the Select All item, so you must do that 
yourself, like this: 

myErr = MCGetCoiit rollorTrifotjnyMG, imyCoutroUerFlafts); 

If (inyKrr != noErt] 

myCDULroilerlfTags = OL: 

IfiiKditingKuabled = 

(ncInfoEditiugErtabled fit myControllerFlags) I- 0; 
it (isEditingEnabled) 

EnableIteTa{GetHHaudle{iiiRdi r), iSclccLAll): 
else 

Di sabl (Gel Hlland le (raEdit) , iSelectAll): 


44 


PROf,n,\MMiNCi With QuickTime VR 


MacTech • July 1997 








Next, tht? QuickTime VR itiovic controller manages the 
cursor whenever it's within a VK movie, changing its shape at 
apprcjpriate [iines (such as when the cursor b over a hoi spot). 
The (QuickTime VR movie controller doesn’t restore llie cursor to 
the arrow shapt^ when the cursor moves outside of the movie. To 
do that, you c'an put this code in your idle event pftxes,sing code: 

ir (rb«Windov “ FrantWlndowO) f 
Rect nay Bert: 

(iniyPoint); 

KCCe t Controller Bound sRect (tmyRect ); 

if (I PtInRect (inyRoini ♦ myRert)) 

InltCursort): 

I 

This cursor-adjusting code is currently needed only for 
Quickrime VR movies, hut should prohaljly lx.' called by any 
QuickTime-savvy ap[>licaiiQn. 

You'll notice that weVe used several movie controller 
component functions with a QuickTime VR movie. This 
underscores once again the fact that QuickTime VR movies are 
just sfiecial kinds of QuickTime movies. For instance, you oan 
hide the controller bar by executing this txwJc: 

MCSetVislble(piyMC* false]; 

In general, you can use :my movie controller funtiions with 
QuickTime VR movies, extepi those that si)ccifically relate to 
time or movie editing. It would make no sease, for example, to 
issue the movie controller action mcActionGoToTime on a 
(Quicklime VR movie. When Quic:kTimc VR movies do involve 
tempf>rai aspeds (for instance, an anijnated object movie has a 
play rale), die QuickTime VR Manager provides functions that 
you can use to manipulate those asptxis. 

llie QuickTime VH nuwic contndler also supports movie 
controller action filters. Thai is, you can intercept a VR movie's 
controller actions and react accordingly. So virtuaSly the entire 
QuickTime programming interfaces are applicable also to 
Qutc:kTime VR movies. 

So far, weVe shown how to .support Quickl’ime VR movie 
playback, and even provide a significant level of 
cusTomizaritm of ihe movie playback and user interface, just 
using standard QuickTime movie controller functions. The 
sample application VRShcU provides a concrete example of 
this capability, ft's built on MovieShell, a QuickTime-savvy 
framework v^riticn by Apple DTS. All of our remaining sample 
applications are built in turn on VRShelL 

OvTiRviEw Of Till: QuickTiml VR Manager 

The QuickTime VR Manager provides a large number of 
capabilities that you can use to ctLStomize and extend the user’s 
virtual experience of panoramas and objects. Here we’ll 
summarize the basic capabilities of the Quickl’ime VR Manager 
Then, in the following sections, we’ll illiLstrate how^ to use some 
of them. In this article, well keep things fairly simple; in the 
future, we hojK* to illusmate some of the more advanced 
capabilities of the Quick^rime VR Manager. 
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The QuickTitiie VR Manager pKwidcs these main capai)iliLics: 
Positioning. A VR movie file contains a scene, which is a 
collection of one or more nodes. Each node is either a 
panoramic node (a '‘panorama”) or an object ntxle (an 
“objecEO and is uniquely identified by iLs node ID. Within a 
panoramic node, the user's view is determined by three 
factors: the pan angle, the tilt angle, and the vertical field of 
view. For objects, tlie view is also detennined by the view 
cenren lire QuickTime VR Manager provides functions to get 
and sei any of ihe.se iiems. For instance, you can 
programmatically spin an object around by repeatedly 
incrementing the current pan angle. 

Hot spot handling. You can use the QuickTime VK Manager 
to manage any hot spots in a panorama t)r objeci. For 
instance, you can trigger a hot spot programmatically (tliat is, 
simulate a click on the hot spot), enable and disable hot spots, 
determine whetiter die cursor Ls over a liot spot, fmd all visible 
hot spots, and so forth. You can also install a callback routine 
that is called whenever the cursor is over an enabled hot spot. 
Custom node entering and leaving behaviors. The 
QuickTime VR Manager allows you to perform actions 
whenever the user enters a new node or leaves the current 
node. For instance, you might play a custom sound w^'hen the 
user enters a particular node. Current versions of QuickTime 
VR support scenes that contain both panoramic and objea 
nodes. If you want to treat object nodes differently from 
panoramic nodc.s, you can use node-entcring and node¬ 
leaving procedures to do any necessary processing. 

Getting information. You can use the QuickTime VR 
Manager to gel information alx)Ut a .scene or about a speciHc 
node. For instance, you might want to determine die ID and 
type of the current node. Much of the information about scenes 
and nodes is stored in atoms in the movie file. To get 
information alx>uL a .scene or node that i.sn't pixwided directly 
by the QuickTime VR Manager, you’ll have to use the 
QuickTime atom container hinctions (introduced in QuickTime 
version 2d) to extract information from thase atoms. 
Intercepting QuickTime VR Manager functians. You can 
intercept calls to some Quickd’ime VR Manager functions to 
augment or modify their behavior. For example, to assign 
behaviors to custom hot sp<jts, you can install an intcrt:c[)i 
routine to be called whenever a hot spot is triggered. Your 
intercept routine would check the ty^pe of die triggered hot 
spot and then perfonn tlie correct actions for that type. 
Another common use of intercef>t r(.}utines is to intercept 
positioning functions (changing the pan, tilt, and field of 
view) and adjust environmental factors accordingly. 
Accessing offscreen panorama buffers. QuickTime VR 
maintains two offscreen buffers for each panomma, a back 
buffer and a prescreen buffer. The back buffer contains some 
or all of die data in a panorama image track, which is a 
stazidard QuickTime video track whose frames contain slices 
of a cylindrically warped and rotated version of the original 
panorama. The prescreen buffer contains the unwarped and 
unrotaied image that is about to be copied to the screen. 


You can use QuickTime VR Manager fnnaions to access die 
back buffer and die prescreen buffer Wliieh buffer yc>u draw 
into Is determined by the effect you want to achieve. To overlay 
a graphic {such as a head’s-up display) that is unaffected by the 
uscE.s paitning, tilting, or zooming, you would draw into the 
prescreen buffer. To overlay a graphic diat is affected by changes 
in the view, you w^ould draw into the back buffer. Back buffer 
drawing is a bit tricky, however, because the images you draw 
there must be rotated and warped if they arc to appear correedy 
on the screen. (Note; in future versions of QuickTime VR, the 
back buffer might not be rotated. The QuickTime VR Manager 
provides a way to check whether it is rotated or not.) 

TTus list is not exhaustive, 'ilie Quicklime VR Manager 
pntwides many other capabilities as well. For a complete description, 
see the book Virtual Reality Prograiiaiting Widi QuickTime VR 2.0* 

Starting Up 

Before you can do these neat tilings with tfie QuickTime VR 
Manager, you must do a little setting up (over and beyond wliaFs 
required for using QuickTime). First, of course, you must ensure 
that die QuickTime VR Manager Ls available in the current 
operating environment. As you'd expea, there are seveml Gestalt 
selectors that you can use to see w^hether the QuickTime VR 
Manager is available and what feattires it ha.s. Here well .spare 
you die details on calling Gestalt; consult die sample code (or the 
reference book) if you absolutely can’t live widiout seeing them. 
The QuickTime VR Manager keeps tmc'k of QuickTime VR 
movies using an identifier called a QTVR iastance (of data type 
(TTVKInstance). Virtually all QuickTime Manager calls ojx^rate on 
Q1VR iasrances. You can think of an instance as representing a scene 
— that is, a collection of nodes, or sometimes (list the cunent node. 
You get a QTVR instance liy calling die QTVRGetQTVRIasiance 
funaion, as shown in Listing 1. QTVRGetQTVRInstance tak^ a 
reference to a Q1VR track, which you can get by calling 
QTVRGeiQTVRTrack. (In general, you'll never do anydiing else to 
the QWK track, so you can siifety foiget al^out it.) 

listing 1: InilApplicationWindowObject 

void InitAppllcatlonWindowObject 

(WindowObject theWindowObject) 

Track niyQTVRTrack ^ HUTjI.: 

Movie inyKovie = NULL; 

MovieCoitt roller tnyHC = NULL; 

QTVRIostance inylnstaiice = NULL; 

if (theWindowObject “= NULL) 
return: 

// make sure we can safely call the QTVR API 
if tSgQTVPM^rlsPresent) 
return; 

// find tbc QIVR track 

ityMovie = (*‘thoWindowObJect). fMovie: 
niyMC “ {* *theWindowOb ject) .fController: 
myQTVRTrack = QTVRGetQTVHTrack[myMovle, 1); 

// get a QTVR instance and remember it 

QTVRGetOTVRInsLnntcCfiiniy Ins Lance, iJiyQTVRTiackt myMC) : 
f^DhoWindowObject] .fInstance = mylnstaiieet 
// do any Q'FVR window configumtion 
if (myInstance 1= NULL) f 
// set units to radians 

QTVHSetAngularUnits(myInst3nce. kQTVRRadians); 

I 
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The IniLApplicationWindowObject funaion defined In 
Listing 1 takes as a paraiiicter a window object, which Ls a handle 
to a data structure associated with each window containing a 
QuickTime (or QuickTime VR) movie; 


typedef struct f 


WindotfRef 

fWindow: 

// the window 

OSType 

fObjectXype; 

// app^spetific window mg 

Movie 

fMovie: 

// the main m<jvie (QT or QTVH) 

MovieControllet 

fContraller; 

// the movie controller 

FSSpec 

fFiloFSSpec: 


short 

fFilGResID: 


short 

fFileRefNiuiL: 


QTVRInstance 

fInstance: 

// the QTVRInstancc 

Handle 

fAppData: 

// a Jiandlt lo app^specific daia 


} WlndwObjectRecord. ’‘WindovObjeetPtr > “VindowQbject; 


The fields of this stmeture contain, among other things, 
references to ilie movie and movie controller and die QTVR 
instance. Ihe field lAppData is a handle to any other data that 
might have to be associated with the window. For the time 
Ixjing, wcT ignore that field. 

Notice that Listing 1 calls the QTVRSetAngularUnits function. 
The QuickTime VR Manager can work with either degrees or 
radians when ^specifying angular nieasuremcnls. The default 
angular unit type is degrees, but you can change the airrent unit 
type by calling QTVRSetAngularUnits, Internally, the Quick'fime 
VR Manager always uses radians, and in some situations gives you 
measurements in radians no matter what the current angular unit. 
In general, therefore, we find it easier to work in radians most of 
the time, so we reset the angular unit type to radians, (Your 
preference may vary!) Of course, we can define .some macnexs to 
convert degrees to radians and vice versa, should the need arise: 

/Mefine kVHPi ((float)3.1415926535898) 

//define kVR2Pi ((float) (2.Q ‘ 3.1415926535898)) 

//define QTVRUtilE_DegreeEToRad1anfl(x) \ 

([floaL)((x) * kVRPl / IBO.O)) 
//define QTVRUtilOUdlansToDegrees(x) \ 

((float)(tx) ‘ ISO.O / kVRPi)) 


Where Am I? 

Finally, weYe neady to use the QuickTime VR Manager to do 
some real work. The mast basic way to use tlie API is to cxjntrol the 
view parameters of a node ™ the pan, tilt, and field of view angles. 
Listing 2 defines a function that gradually increments the pan angle 
tliniugh 360 degrees. Wiili panoramas, ihLs h;LS l.lie effect of making 
the user seem to spin a hill circle (as if die user is spinning on a 
rotating stool). Witli objects, tliis lias the effea of making the objea 
spin anmnd a full cinJe (as if the object is spinning on a lazy Susan). 

listing 2; SpinAroundOnce 

void SplnAroiindOnte (QTVRTristance thelnstance) 

( 

floai iflyOrigPafiAngle, layCurrPauAugle: 

TDyOrigPanAngie - QTVRGetPanAngle(thelnstance) ; 
foe (iijyCurrPanAngle = myOrigPanAngle: 

ntyCurrPanAngle rayOrlgPanAngle + kVR2Pi: 

myCurePanAngle +" QTVkUtlls_DegreeaToRadianE(lO.O)) I 
QTVRSetPanATigle(theInstanco, myCurrPanAngleJ; 
QTVRapdate(theInstance, kQTVRCurrentMode); 

I 

I 
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The idea here is simple: get the starting pan angle (by calling 
QTVRGetPanAnglc) and then repeatedly increment tfie pan 
angle by a certain amount (here, 10 degrees) until a full circle has 
been traversed. Note that we must call the QTVRUpdate function 
after we set a new pan angle to make sure die updated view is 
displayed on the screen. 

OvERij\YiNG Images on a Panorama 
Suppose you wanted to display a logo or otlier grapliical 
element in the comer of a Quicklime VR panoramic movie (in 
rhe way that some TV channels often do to discourage pirating). 
Because tlie overlaid logo isn't affected by the view settings, we 
can just draw' it into die panorama’s prescreen buffer, 

We must keep track of the pkmre to be dr^iwn, so we’ll 
create an application data record and .store a handle to tliat 
record in the fAppDaia field of the window object record. For 
present purposes, our data record can look like this; 

typedef struct { 

PicHandl e fPicture; // Uit pictuiv lo display 

Boolean f Display P let ur a: // ia the picture to it displayed? 

] ApplicationDataRecord. *ApplloationDataPtr. 

' *AppIicat.ionnataHdl; 


Well get the overlay picture from a PICT resource, in a 
window data initialization routine (shown in Listing 3) called by 
the application’s InilApplicationWindowObjecl function. 
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Listing 3: VRLogo_InitWindowData 


Appl 1 cat i ohBataHdl VRLngo_lriitWindowData 

[Wi ndowObJf^cT 


1 

ApplicaxionDataHdl myAppData: 


t heWIn d owOb j ec t) 


myAppData = (ApplicationDataHdl) 

NewHandleClea r (£ izeof (tUYAppData)); 

If (jnyAppData NtrT.L) 1 
// get the pkiure to overlay 

{* *niyAppData). fPieiurc = GctPlcturp(kPictureRealD): 


// set mitial dif>plav ^taic 

C*^rayAppData).fDispiayPicture = Xxnei 
I 

return(myAppData ); 

J 


Also, in die applienrion's InirApplicarionWindowOhjeci 
funcUon, we must install our prescreen buffer imaging completitm 
prtK'cdure, wliich is called by the Quick'Ilnie VR Manager each 
time the pt^screen buffer is atxiut to be copied to the screen. We 
can in.stall our prcx:edure like this: 

if tQTVRCetNodeTypetmyinstanctv, kQTVRCurreniNode) 

= kQTVRPanoramaType) 

I 

ImgingGompleteUPP ntylmagingProc: 


[ 


myTmagingProc " 

W ewi ma gin gCoinp 1 L 0 P roc (V RLogo_ P re s c ree n Ro u 11 n e); 
QTVRSetPresc refnlutfiglngCoinp] c leProc (my T nn tance» 

myImflgingProc * (Sliit32) theWlndowObJect, 


0 ]: 


The lliird parameter to QTVKSetPresaeenlmagingCompieteProc: 
is an application-specific reference constant valtie; here we pass die 
window object reference, so the pre.sc:reen buffer can access tlie data 
ass<x:iated with tlie window. 

Our prescreen buffer imaging completion procedure is 
called after QuickTime VR has finishc-d drawing into the 
prescreen buffer. When ifs called, the curieni graphics port is set 
to the prescreen buffer. All we need to do is draw the picture at 
the appropriate spot, as shown in Listing 4. 

Listing 4: VRLogo^PrescreeiiRoutine 

pascal OSErr VRLogo_PrescreenR[>i]tine 

(QTVRInstance thelnstance, WlndowObJeci: theWlndowObject) 

I 

//pragma untis&d (the In stance) 

AppllcationDataHdl myAppData; 

Rect myMovieRect: 

Reel myPlctRect; 

// giCL ihc appliCiUiorHSpccific duta associated with thtf window 
myAppData = {AppilcationDataRdl) 

GetAppDaraFroniWindowObject (theWindowObject); 
if (myAppData “ MULL) 
return (paratnErr) ; 

// i/ ihcrc b no picture to display or dbplaying is toggled off, just rcium 
if ((•'myAppData)HfPicture — NULL) 
return(noErr); 

if (!(*'myAppData).fDisplayPicture) 
return(noKrr): 

// gel the cunciil size of the movie 

GetMovieBoxt (* 'theWindowObjectl . fKovie. ^iriyMovieRect): 

// set the size and position of the overlay rectuiigle 

SetRect,{AmyPictRect, 0, 0. 32. 32): 

OffsetReelt&myFlctHRet. 

myMovieRect,right ^ (myPirtRact.right + 5). 
myMovieRect.boilom (myPictRert.bottom + 5)): 

// draw the pictujiG 

DrawPicture( ("myAppData) .fPicture, jdnyPictRect) : 
return(noRr r) : 

) 


'fhere's nothing veiy compliciiLcd in tlus prescreen buffer 
imaging coinplcLion [>rocedure. Essentially, it just figures out 
where in the buffer to draw the picture and then draws it. 

Mote that the current release of ihc QuickTime VR Manager 
maintains prescreen buffers only for panoramic nodes. Ifs 
possible, however, with a little effort, to create your own 
prescreen buffer for object nodes and then perform the same 
kind of overlays that are fx>ssible with panoramic nodes. 

IfSTIGRATING WITH OTHER MeDIA 

Much of the real power provided hy the QuickTime VR 
Manager derives from the ease with which it allow.s you to 
integrate YR movies with otlier media, such as video, sound, and 
3D objects. In a future article, well show how to embed 
QuickDraw 3D objects in a panorama. In tlie meantime, weT 
give you a good taste of whafs possible by showing how' to 
integrate Quick'l ime VK and SoundSprocket, the pan of Apple 
Game Sprockets that supports loc'ali^ed sounds (diat is, sounds 
emanating from a s|3ccific location in a panomma). We D suppose 
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that y(Ju'a* alrt^ady familiar with SoiintLSprc>t:kct but ilic ideas are 
M) j^imple tli:t[ you can proliably f(jlk>w along even if y<iii aren't. 

SoundSprocket provider a virtual audio environ men i 
consisting of a single listener and one or more sound sources. 
Tiic listener and the sound sources all have independenl 
posilk)ns in 30 spat:e. In addition, tlie listener and sound s<iiirc’es 
all have independent orientations in 3r^ space. Tfie haste idea 
Wiind our sample application is that the listener is situated at 
the mxlal point of the panorama (the point around which the 
panorama tttrns) and is looking at the center of the movie 
window. As the user interactively changes the i>an atid tilt angles 
of the panonima, the fixed l(H:alk)ns of the .sound sources change 
relative to the listener. (.SoundSprtx’ket dcxvsn'i actually a!<|uire 
that the Mmnd .sources have fixed kx'arions, hiu well kee[> tlie 
Icxatitms of our sources fixtxl, tor simplicity.) 

'ITie data w'e need io iiiiiintain for each Vk movie has this 
stnuiure: 


typtjdef cUruct I 

SS pLi :i t y r R c f c re n thh 

S S pS<>u t c y Kt* f t‘ r 01R' e 

SndChanneit’tr 

SndLl^tHandle 

float 

flour 

I Appti€*at IonDataRecord, 
* *AppllcaLlonDaLaHdl; 


fListener; 

fSources LkHaxNuraSourceslc'rWutleJ ; 
fChanitaia rkHaxNuaSourcesfetNode] i 
IkMaxHumSourcesPerKod^J; 
fPrErvPaJiAngVa; 
tPravTiItAngle: 

'AppllcatiotiBataFir» 


We’re keeping track of the listener and the sound soitrees 
usetl l>y SoundSprtxket, as well as a .sound channel and a sound 
resource for each sound in the panorania. Finally, we're keeping 
track of the previous pan and lilt angles, which we’ll compare 
with the cura^nt pan and tilt angles to determine whether we 
need to update the listener's orientation. 

We’ll skip over the details of selling up the virtual audio 
environment. What's t>f inieresi here is the way in w^hic^h we 
rranslale changes in the Vk movie’s pan and litl angles into 
elianges in the listener's orientation. We do tliis iLsing a prescreen 
buffer im;iging completion prcx'edure, not because we want to 
amially dniw anytliing into the prescreen buffer, but simply 
Ixcause we w'anl to be called whenever the pan or Lilt angles of 
a panorama have changed and (therefore) a new view ts about 
to lx* displayed. Our pre.sereen routine Ls shown in l.isiing S. 

IJsting 5: VRSDSound^PrescreenRoutine 

pascal OSKrr VR.IDSoynd PrescreenRoutine 

(QTVRiiiatatice Lh(?Tni3tanc€! * WindovObject theWindowObj<*cl) 

1 

float myPan; 

float inyTilt; 

TOlVfK'.totSD myOtientatioti; 

AppllcoUonDataHdl myAppData; 

uyAppUiita * (Appl tearianDataHdl) 

GolAppnataFrnraWindowObject (theWiivdowObjeci): 
if (myAppDeta “ NULL) 
return(paramErr): 

// the current pan and lilt angic?i (in n«3iansj 
my Pan ” OTVRtip.tPaiiAngle(thaInstance) ; 
tayTili « QTVRGetTiltAnf^letthelnstance): 


// tkTtTmifif wlieiher ihc dll angle Jia* ctiangcd 

if KinyParj ^ {•^iiyAppDatal .fPrevFanAngle) && 

(myTilL -- (“myAppData).fPrevTiltAngle)) 
return(noErr): 

(* * my AppData), f PrevpanAiigle = my Pa rt: 

('*myAppData)-fPrevTiltAnale - myTilt: 

// figiift- flirt the new urienMiun uf the listener 
myOrierilotlon iX - sin (myPan) * costrayTill) ; 
myOrientat ion, y a i n EmyTl It): 

layDrlentation.z “ coa(myPan) * cos {myTilt): 

// set the new orienixiifiii of the Usicner 
SSptJsiTfiner SetOrieniatlon 

C(**myAppData) .fListener, iitnyDr ientstion); 

// ii^Tdsitc the virtual audio cnvifxtnnKnt 

VR3 D S ound^LI pd a L c 1 n Sou n d Rn v (t heWin do wOb j act): 

return{noErrJ: 


Once iigatn, there Isn't anything very cojnplieateil liere. Tliis 
prcMTeen routine gets the current pan and till angles and then 
(using a little elementary trigonometry) converts those angles 
into a point in ihree-dimensional .space. For .simptieity, weVc 
as^sumeti that the sound sources are all Icxated one unit away 
from tlie listener, but it wcnild Ixj (juite trivial to remove that 
restriction. ‘Hien the prescreen routine sets ihc new orientation 
for the listener and ujxlates the virtual audio environment. 

The source code for the Vk3r)Soimd sjim[>le application 
contains (in addition to all the necessary SoundSprcx'ket 
processing) ixxJe for ojxiiing sound resources and slopping a 
ntxle’s .sounds when the user moves to a new ncxie. Tliat code 
illusirales how to use node-trnfcring and node-leaving pnx'cdures. 

INITRCLFTING QuCKTiMF. VR 
Manager FiiNtnoNS 

Supjx>.se you want to play u sound every time the tuscr 
clicks (that is, triggers) a hot spot. The ea.stest way to do this is 
to install an imercept procedure that is called each time a hot 
sfK>i is triggered. ’Hie intercept [irtxcdure simply plays the 
sound and then ret urns. wliCTCupun (QuickTime VR prtxesses 
the hot spot click us usual. Listing 6 shows a simple hot spot 
triggering intercept procerliire. 

Listing 6: VRSample_lntLTeeptRoutine 

void VRSaiiDple_lnt£;rcepl.KoiUtn(^ ( 

QTVRInstance LheTnStaTine, 

Q'rVRlntetcepLftr IhoMsg* 

WindowObject theWindowObJert, 

Boolean * cancel) 
t 

Ipragma unused (theitisLanco* theS/lndovADbjecx) 

Boolean nyCancelliUcrcopiredPrDc " false: 

Qwtfch (thEHsg->EelectQr) t 

case kOTVRTriggerEotSpotSe tec t or: 

MyPlaySound(); 
break: 

default: 

break; 

1 

‘cancel * myCancellntetcepTadProc: 

I 
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An intercept routine is executed whenever the intercepted 
routine is otlled, either programmaticaily or by a user action, 
(We'll show you shortly how to specify which routine or routines 
you w^ant to intercept,) On entry, ilie QuickTime VR Manager 
provides three pieces of information: die relevant QTVR instance, 
a pointer to an intercept record, and an appliotion-defined 
reference constant, which wc use here to pass in the window 
object. The intercept record (pointed to by the theMsg 
parameter) has this structure: 

typedof struct QTVRlnterceptRecord ( 

STnt 32 rt'servedl: 

Slnt32 selector; 

Slnt 32 reserved 2 : 

SInt 32 reserved 3 : 

SInt 32 paramCount; 
void ‘parameter[ 6 J 3 
] QTVBTnterceptRocord* ‘QTVRlnterceptFtr; 


For present ptirfioses, we need iaspect only the seieaor 
Field, which contains a constant that indicates wliicli intercepted 
routine is lieing called. As you can see in Listing 6, we simply 
look for any calls to QTVRTriggerHotSpot and call the 
application-defined funaion MyPlaySound when we gel one. 

You can install an intercept procedure by calling the 
QTVRInstalllnterceplProc function, as shown in Listing 7* 


listing 7 : VRSaiiipk_IiistaUliiterceptRoutinc 

void VKSaraple_InstallInterceptRQUtine ( 

QTVKInstance ihelnstance. 
WindowObj ec t theWindowObj ec t) 
t 

OTVRinterceptUPP roylnterceptProc; 


raylriterceptProc ^ 

NewQTVRInterceptPcoc{VRSaniple_InterceptRciutlne): 

(iTYRInstalllnterceptFroc: (thelnstance. 

kQTVRTriggerHotSpotSelector, 

inylnterceptFroc, 

t Slnt3 2)theWindowObj ect. 0): 


ViRTUAixY Finished 

It seems like weVe barely scratched the surface of the 
QuickTime VR Manager, but even so weVe illustrated some very 
powerful capabilities for managing Quick'l'kne VR movies 
programmatically, WeVe shown how to perform basic 
positioning of the viewer, how to alter the displayed image by 
drawing into a panorama's prescreen buffer, how to link the 
orientation of a listener in SoundSprockei's virtual audio 
environmenr to the QuickTime VR view angles, and how to 
intercept some QuickTime VR Manager functions. Not bad for 
jasl over a hundred lines of code! 

We mentioned at the outset that tlie QuickTime VR Manager 
allows you integrate QuickTime movies and QuickDraw 3D 
objecLs with QuickTime VR panoramas and objects. Now that 
you've seen how to use the VR API, and particularly how to 
support SoundSprocket, you can probably figure out how to do 
at least the QuickDraw 3D integration yourself. If not, don't 
despair Just have some patience until we show you — in our 
next article ~ how to play movies and render 3D objects in a 
Quicklime VR panorama, 
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MULTIMEDIA 


by Tim Monroe, Apple Computer, Inc. 


The QuickTime Media Layer 



An overview of Applets 
flagship multimedia 
software 


iNTOODUCmON 

Imagine that you're standing ki a 
muscLitn, surrounded by famous works of 
art. On the wall in front of you hangs a 
painting by Jackson Pollack. You reach out 
and toudi the painting, and instantly a 
screen slides down in front of ilie painting; 
on the screen appears a video showing 
Pollack in the pnxess of splavShing paint 
and slabbing wildly at the canvas. Stx)n it 
Ixjcomes clear that he's working on the 
very painting that liangs in front of you. 

You move to the next rof>m. As you 
enter, a voice announces llial this room 
contains the last few remaining vases from 
the Ming dynasty. You go to the center of 
the room and walk aroimtl the blue and 
white vase that sits on a pedestal. Tlien you 
pick up die vase to examine it further: you 
want to see the tottom and to look inside 
the vase. Suddenly, off lo die riglit and a bit 
behind you, you hear a crash as a vase 
c:ollides with die marble Roor. As you mm 
and look, a crowd of sclioolchildren 
hurriedly moves away from a pile of 
shards. IJnfazed, you utter the plirase 
"reassemble the vase, pirase." The shards 
swirl up into a spinning cloud that 
eventually settles gracefully onto its 
pedestal as a complete, unbioken vase. 


Then you move Into a third room. Large mobiles hang from 
the ceiling. You click a switch on the wall and a fan l^egins to 
spin, gently blowing the mobiles and setting diem in motion. Ihe 
fan hums and die mobiles creak and clang as they move and 
collide with one anoUier. After a few minutes, the fan stops 
abruptly. A wall, previously blank, now displays a live video 
piaure of a security guard announcing that the museum will Ix! 
closing soon. You leave die museum. 

This experience — this multimedia experience — seemed so 
real diat for a few moments you pertiaps foigot that you were 
sitting in front of a computer. You almost felt mrry for the 
schoolchildren when diey aeddentaliy smashed ilic vase. And 
you almost even thought you could feel diat hard marble floor 
under your feet as you mtived around in your virtual museum. 
What made this expcTience real, what made it seem as if you 
were immersed in another world, was the set of Apple multimedia 
technologies collectively known as the Quickrime Media T.ayer 
(QTML). In this ajtic:le, HI provide an overview of the QTML. ril 
describe the main components of die QTML and highlight some 
of tile key interrelations among those components. 

WiiAT Is QTML? 

In a nutshell, the Quicklime Media Layer is a codection of 
Lcdmologies developed by Apple Computer that allow anihoring 
and pla^iiack of mullimcdia content. 1here arc diree main 
technoiogies currently included in die QTML: Quicklime, 
QuickDraw 5D, and QuitkTime VR. (As we'll see later, there are 
several other technologies that are Icxisely ass<K:iaLed witli the 
Ql'ML.) What distingidshes each of these tedmologies, and makes 
diem suitable for inclusion in the QTML, are these features: 

• The technology i.H tmdia-rich. Tlie Q TML provides, first and 
foremosL, an avenue for the delivery of digital media. QTML 
technologies pertain to the eyes and ears. Other sensory 
modes, if digitiml, would Ik* prime candidates for inclusion 
in the QTML. For instance, some joysticks can pixwide tactile 


Tim Monroe <monroc@apple.coin> is a s^>ftware engineer on Apple's QuickTime team, resfiorisible for developing 
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team, where lie wrote developer documentaiion for QuickDraw 3D, Quick'rimc VR, die .sound and speech teclinologie.s, 
and a of ocher APIs. 
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lucdl?ut:k, and a genenil intedace So such device?; woiilcl 
make a nalura! QTML component. Well probably have Lo 
wait a v^^hile, however, for ()Ifacior>^ (QuickSmell?) and 
gustatory components (QuickTaste?) of the QTML 

* The technoltJgy is interactive. It's great to sit and watch 
things happen, but it’s essential for most everyday uses of 
media delivery that the user be able to interatl with the 
environment. Accordingly, the core QTML technohtgies 
provide some means for users to cxmirol the environment. 
QuickDraw 5D provides a picking architecture that allows 
the user to move t>r select objects in a scene. QuickTime 
Vh is based almost entirely on allowing the user to choose 
a navigation path through a virtual world or lo manipulate 
an ol>iect in a virtual world. Bven Qukkl'imc — long tlie 
prime example of ^h and watch” — is moving toward 
increased interactivity. 

• The iet:linok>gy is cross-pkaform. 11ie QTML is based on a 
strategy of “audu>r t>rice, deliver many.” Ideally, applications 
clevelopers should Ix^ able to build i>!ayixick applications for 
the major personal computer 0 |XTaiing systems, inciuding 
MacOiS, Windows 95, and Wintlows NT. (QuickTime iLself 
currently also runs on OS/2 and several flavors of UNIX.) Ju.st 
as impofumtiy, developers should Ix’ alile lo Irijiid authoring 
systems for any uf these platforms, llotii of ihe.sc^ needs on 
lx served by [>roviding a sei of croxs-platform application 
programming interfaces (APIs) for QTMl. t‘omf>onents. 

• The iet'hnolog}' supports a standard file format. This feature 
is just as important a.s the cross-platform Al^Is jusi 
mentioned and prt>vidcs a key part of the Q'LML cross- 
p tar form delivery strategy. A standard, fully documented file 
fonnai is alsci imptirtant to fx^rmit data exchange Ixiween 
aj’Jplications running on the same operating systenc For 
instance, the 3D file formal supported by QuickDraw 3D 
provides a means of sharing 3D data between applications 
and across platforms. QuickTime and QuickTime VR also 
support a publicly dcKumcnled file format. 

* The technology is •icalmble. Tlie cgjality of the user's 
cxfXTience wiien intenicting with multimedia content should 
depc^nd primarily t>n the aipabilities of the user's lianiw^arc, not 
on the limitaiit>n.s of the multiniedia content or playback 
.software. All the main Q'lTVIL techiKjlogios am take full 
advantiigc of ilic available memory t)r cither haixlware on tlie 
user's computer. l\>r example. QirkkDniw 3D uutomatic'ally 
uses any available supported 3D acceleration nind to speed 
rendering and other opcTations. Similariy, a QuiekTime V1^ 
panoratita can lx viewed at differing resoluiioas, depending on 
the amount of available R/\M. QuickTime can tike advanuige of 
muliittle prcxeicsors on the MacDS to sjxed iLs calcxjlatioas. 'Tliis 
scaleability Ls anoiher htcel of the “author once, deliver many” 
philosophy: the s;ime data file can provide vastly differertt 
exfXTiences, depending on the availalrle haitlware. 

In short, die QuickTime Media Layer provides a plalform- 
independent standard for die crc-aiion, distribution, and playliack 
of digiial media, including video, sound, lendered objects, 
immersive panoramas, and manipulable objects. 


The Stars 

N<jw let's take a brief knik at the three principal parts of 
the QuickTime Media Layer: QuickTime, QuickDraw 3D, and 
QuickTime VR. 

QuickTime 

QuickTime is the core of rhe QTML. It provides a cross¬ 
platform multimedia architecture that allows integration of a 
wide variety of media data types, including graphics, .sound, 
video, text, music, 3D objects, and .sprites — with the ability to 
synchronize all these media types lo a t'ornmon time base. In a 
word (or two), (QuickTime manages time-based data. A 
collection of time-basetl ckrta is called a movie. QuickTime 
provides tcx>Ls to display movies and to let the user interact with 
movies in appropriate ways (starting, slopping, pausing, and so 
forth), h also provides the capability to interact with movie dua 
in other ways as well (compressing, expanding, cutting, 
pasting, copying, ami so forth). 

In the years since it was intrtxluccd, QuickTime has 
gradually added supptirt for a nunilx^r of media data types. For 
instance, QuickTime version 2.0 addctl support for the 
QuickTime Music ArchitecUire (more on lhal later) and version 
2,3 added .support For MPFG-encoded video. Current versions 
of QuickTime support 3D data and sprite tracks. It's fairly easy 
to add support for a new data type lxcau.se QuickTime is built 
on a ctmiponent architecture. (A component is a piece of crnle 
managed by the Component Manager that provides a defined 
set of services to one or more clients.) Hach QuickTime 
component provides an riiierrace lo a set of features as.scx’iated 
with the manipulation of some sort of data (which might or 
might not be time l>ased). 

rhe latest version of QuickTime for Ixifh MacOS and 
Windows machines is (QuickTime 3.tL which provides several 
im]>orlanl advancemenis over previous versions, iiictudmg 
expanded file formal sutifiori, a media abstraction layer, and 
accelcTated visual effeils: 

• QuickTime 30 supports playback, editing, and integration of 
QuickTime data, MITX3 files, AVI, OMK DVCAM, and 
OpenDML files, ihereiiy providing one of the highest levels of 
inlcgration with all major video file fomiats. QuickTime 3.0 
also SLipports a watk* variety' of sound rile fomiats, including 
Wave, AfFl', AU. Ml^FG Liyer 2, and MIDI formats. 

• 'rhe new^ media al^straciion layer provides Quic kTime with 
a means of accessing hardware accelerators or other 
multimedia enhancemenis in a way that is transparent to 
the .software using the QuiekTime AFL This en.sures that 
existing applications will benefit from these enhancements 
without any changes. 

• (QuickTime 3.0 includes enha.ncemeni.s to the QuickTime 
.software architecture that staodardi/.c the way in whic:h 
applications work with visual effects and transitions. For 
example, QuickTime 3 0 includes a large .set of built-in 
software-based effects, such as cros.sTades, chroma keying, 
SMITE wipes, and color Lidjustments. 
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From ihc pntJgnuTimers fxnru of view, it’s tvluiively easy to 
atkl sup|X)n for QuickTime movies to an appiicaiion. With a few 
lines of cckIc, you can open a movie tile anti piiovitle a siandtixl 
user interface fur the user to t:oniix>I Lire nujvie plavlxtck. The 
jTitwie file itself can conUiin all the data needed to synchroni/je the 
varit)us data types displayed in the movie. Quit'kTime also provides 
a hn^e set of funciions for tu‘atin^ and editing movie data, 

QuickDraw 3D 

QuickDraw 51> Is a crtxss-plartdrm ^niphit^i library^ that you am 
use to t:raite, configure, and render 3D models. You can also Lise 
QuickDraw 3D to matiage user interaction with a lendercxl 31) ,scene, 
such as navigating within the scene (rhiir is, changing ihe camera 
angles) and selecting objetts in tlit^ M'ene. QuickDraw 5t3 sui>[K>jts 
a wide range of Ixisic geomeiric objects aixl iniasfomiations trf' 
oi>jects, as well iis attributes for those olifeas. Quic kDraw 3D also 
supplies several ligliting mtKlels, shaders, and nendcreoi. 

'ITe QuickDraw 3D graphics liljraty supports a C-based API, 
Most of the Al^I provides a standard object-orienteil approach to 
3D graphics, wherein you create (^bjetls thai can inherit [)rojK'ities 
and Ixdiaviors from oilier objects. For appliuilions that require 
only the display of 3D objects and limited user mtemetion with 
those ol>jetts, QuickDraw 3D also supplies a high-level API for ilic 
3D Viewer in a sense, using the 3D Viewer is like using the 
standard movie contn>tler to display QuickTime moviesr it's very 
easy to provide a standard interface to the underlying data. 

Like QuickTime, QuickDniw 30 is extensil>le, though not in 
precisely the same manner. QuickDraw 3D does not siippon a 
ctjm|X)nem-based architecture; iastead, it allow.s deveiopers to 
extend its capabilities by defining taistom t>bjeeLs. Mt^reover 
QuickDraw 3D .supp()ris a hardware abstraction layer — called 
ilie QuickDraw 3D Rendering and Acceleration Virmal Bngine 
(RAVE) —that allows for plug-and-play hardware acceleration. 

Quick Dm 3D also defines a platform-Independent file 
format, called the 3D Metaftle Format (31>MF), for storing and 
interchanging 3D data, '11115 fonnar i.5 intended to provide a 
.standard format according to which applicatiotLs can read and 
wriie 3D data (even api)licaliQas chat do not use QuickDniw^ 3D 
to render images), QuickDraw 3D supplies functions that you 
can use to read and write (Lita in 3nMF files. 

QuickTime VR 

'llie new' kid on the QTML hliK k is Quit:kTime VR, an imaging 
tetrhnology that allows users to iritcnictively explore and eximiine 
photorealistic, tliree-dimensional virtual worlds and objects. 
QuickTime VK Ls roilly two separate tecrhnologies in one j>ackagc. 
One pjirt of Quit:kTime VR supjxsrts panoramic ncxles (or 
“iranoiamas"), where the viewer can mm around, its if sitting on a 
rotating st(x^l, to view ditTerent parts of t he S|yace around him or her. 
Ihe other parr of QuickTime VR supports object nodes (or 
‘*ol)jecLs''), wiicre die viewer am turn an object horizontally and 
vertiailly, as tf picking it up ami examining iu Any niiml>er of 
panoramas and ohjeas txin \)c linked Logedier into a scene. Clicking 
predellned areas in a pardaiiar node (‘liot spofs") CAn move the 
viewer to another nixie in the SL:ene or initiate other actioas. 


QuickTime VR is like QuickDniw 3D in that both 
tec hnologies are geared toward spatial data. Both of rht^in try, in 
different ways, to make it seem as if youVe in a spatial location, 
populated by 3D obiects, (QuickDraw 3D is a traditional 3D 
graphic's library, wiieru each and every object in a scene must lx* 
de,scdlx.'d gecjmetrically and rendeaxl in re:Tl time a,s the viewer's 
kx'aiion ehanges in 3D space. QiiiekTime VR, on ttie tHlier hand, 
wixks with cDia that is typically aiplured photographically and 
hence c^an jirovide sulistantial detail with a very .small cLita size. 

QuickTime VR playliack has been available on IkxIi MacOS 
and Windows machines for several years. Fatly this year, Apple 
introdueed a C language API for controlling VR iiKJvie piaybac:k. 
See "Frogramniing With Quickrime'^'^ in this i,ssue for a 
detailed description of that A PL 

The SumiRTiNG Cast 

The k^uicklime Media Diycr is a,ss(Kiaied with several 
other important technologies. Some of these are really part of 
the QTML but deserve special mention, and some are not 
strictly part of the Ql’Ml. bui provide some nifty capabilities 
when used with it. Some of these QTML-waiinalx*es are not yet 
available cross platfonn, however. 

Sound Manager 

The Sound Manager is the |yan of the Quick'l'ime Media biyer 
that imruiges sounds. Por in,stance, when you play a QuickTime 
movie, it's tlie Sound Manager that is ultimately ivs[X>nsili)e for 
turning ihe audio daui mekidcxl in tlie movie into sounds, this 
pnxess might involve a gocxl bit of work. For example, tlie audio 
data miglit liave to be uncximpnrssed; die uncompressed data might 
then re(|iiire that iis playback rate be changed; the rate-shitted data 
might then liavc to liiive its volume adjustetl; finally, the aiKlio dam 
miglit have to be mixed with other sounds already playing. 

'llie Sound Manager is uvailatile on computers running both 
the MaeOS and Window's operating systems, like (QuickTime, its 
operations are handled by a variety of LonifKinenLs, so it is 
relatively easy to add c'apahiliiies (for instance, to handle 
rfiffereni eoiiipression and expansion algorithms) to the Sound 
Mamtger by wanting your own caistom components. 

QuickTime Music Architecture 

Tlie QuickTime Music Airhitecture (QTMA) was introduced as 
]iait of QuickTime 2.0. It provides an interface to MIDI, a .standard 
music* and device-control archileitutTe, but does not reejuire tliat any 
uLtual MIDI devices be attached to the comfiuter. T!ie QTMA am 
play intlividital notes and .set|uenccs of mxes (generated on the fly 
or prerecorded) on any avaikible MIDI device, or on a softwiue- 
Ixised MID! syndiesizcr \f no external devices are available. You am 
also use the QTMA to rvad input from external MIDI devices. 

One advantage of the QTMA is that the amount of data 
required lo generate a tune is significantly .smaller than that 
amount of data contained in a digitized recorLting of that tune. 
If music' figures miportantly in your multimedia content, you 
should consider the Ql'MA as the delivery vehicle. 
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SoundSprocket 

SoiindSprcKkel is ihe part of Apple's Ganie SpirxikeLs tlmi 
provides 3D filtering for sounds. (See [Vineyard 1^>7) for mom 
detail alx>ul die Apple Game Spnx:keLs ptickagej You ean use 
SoimdSprocket to make a sound appear lu emanate from a specific 
point in spate, anti you can cliange the location of the sound 
dynamically, Tlicse capabtlities are espeeialiy iLseful for die Q'rML 
components tliat supixin a spatial medium, namely Quit;kDraw 3n 
and Quickl ime Vll For instance, you can assign specific sounds to 
kx:alions in a iianorama; as die user pans or tilts to change the view 
angle, the location of tlie sounds apix^ars to change as well. 

SoimdSprocket is not offlcially part of the QTML, and 
caiiTcnlly it\s available: only on PowerPC-based MacOS 
computers. Happily, however, IPs fairly easy to duplicate some of 
the SoLindSprocket functionality using QuickTime or die Sound 
Manager. You c^in .simulate 3D filtering of sounds for QuickTime 
movies by adjusting the f>alanc:e and volume of a movie's sound 
track as die user changes spatial jxjsitions or orientadons in a 3D 
.scene or a V(^ panorama. Also, you can simulate 3D filtering of 
sounds played using the S<Hin<i Manager by issuing the 
volumeCmd sound command, w'hich controls die volume ami 
balance of the left and right speakers independently. 

PlaiiiTalk 

Apple provides two speech technologies bundled together 
under the general name Plairifalk: speech synthesis and speech 
recognition. Sjxech .synthesis is tlie process of converting written 
tokens (text) to spoken tokens (speech). This can l>e useful to 
provitle a narmtion of a walk-tlirough or to vocalize a QuickTime 
text track. Sf>eec:h recognition is proces,s of converting spoken 
words into recognized utterances* Tliis Ls u.seful to give the user 
anodier input method. For instance, instead of having the user 
pan and till in a VR panorama using the mouse or keylxjiird, you 
am support speech commands to achieve the same effect* (See 
iFallakoff and Reeves 19961 and [Monroe 19961 for several gtxxJ 
articles descTibing Apple's .speech recognition capabilities.) 

Once again, these technologies am noi officially p^m of the 
QTML, but they can dramatically enhance the user ex|x:rience when 
aimbined willi the multimedia technologies piovided by the Q'FML. 

QuickTime Conferencing 

QuickTime (ajoferencing (QTC) is a set of software 
components that supfxjrt sharing tinie-ha.sed media acro.s.s local- 
and wide-area networks. In other words, QTC provides reablime 
multimedia coirimimications. You could use QTC, for example, 
to support videix:cmferencirig or a "virtual whitdxiard.'' QTC 
provides a number of cf>mponenls for iTianaging tlie network 
interface and (Uher operations, and also uses standard 
Quick'l'inie components when fMxssifile. 

hSTEGRAnON 

'Hie real fim with tlie QuickTime Media biyer is making it all 
work together Each component of file QTML lia.s a programming 
interface, so you t:ari combine components simply by using iJie 
Aids together. One of my favorite early exiiinples of Ql’Mi 


integration is Robert Dierkes' TextureEyes application, which can 
texture^ map a QuickTime movie (or even a live video feed!) onto 
a QuickDraw 3D diject. You could use die same technique ro play 
a movie on a rendered TV screen in a 3D scene. And tlien you 
coiiid Like that rendered object, with its QuickTime movie texture, 
and eml>ed it in a QuickTime VR panorama. And then, with a few 
simple Movie Toollxix functioas, you could adjust die st>und 
balance and make the movie's sound inick get louder or quieter 
as Uie user pan.s toward or away from the "IV set. 

Similarly, ifs very easy u> iniegraie StiundSprcK-kei and 
QuickDraw 30 to attach sounds to specific locations in a rendered 
3D scene. (Indeed, the SoundSpnxtket Aid uses many QuickDraw 
3D data structures to describe die location and orientation of the 
virtual listener and the sound sources.) It's also reasonably easy to 
attach scjunds to specific kxations in a QuickTime VR pimomma 
and to link the orientation of the SoundSprtxkei listener to the 
current orientation of the viewer in die panorama, 

CONtliaiSiONS 

'The QuickTime Media Layer is a set of cross-piatfiirm 
Apple technologies that support the authoring, delivery, and 
playback of muhimetlia content* Used together, these 
technologies provide a means to integrate spatial and temporal 
data into a rich, unified, interactive user extx'rience. The data 
underlying this experience can Ix' genenned dynamically, or 
read from files stored locally, on C IT ROM, or on a remote 
server acces.sed across a network. 

ft's important to keep in mind that die QTML is a unifying 
not a finished product. At the current time, true media 
integration must lx done at the API level or using an authoring 
environment that supports the various media ty^xs. Currently, 
there is no single, unified file format For the many data types 
supfxjrted [)y the stars and supporting cast members of the 
Q'l'ML. Fart of what this means is that there is no easy way 
(again, short of programming or using an authoring 
enviromnem) to animate 3D objem in a QuickTime VR scene or 
to attach sounds to locations in a 3D scene. 

Nonetheless, it's only a matter of time Ixfore software 
developers Ixgin to use the existing APIs to create authoring and 
playback IckiIs to provide a more scamle.ss integration among all 
members of die QTMl. At that point, the QTML will move 
outside tile ranks of programmers and Ixcome the unified media 
authoring and playback layer for tlie rest of us. 
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RHAPSODY 


by Michael Rutman, independent consultant 


Rhapsody FAQ’s 


You’ve heard the rumors, 
but how much is true? 


But a FioENn Tom Mr... 

With today’s ever changing technology, 
finding out infonnation alx>ut future 
technologies can be challenging, especially 
when it is dffiailt to get liands-on 
experien('e with thui tcclinology. Rhapsody 
Ls no exception. Even though Idiapsody Is 
leased on OPENSTEP, whk:h ha.s lxx*n out 
for almost a decade, mtjsi deve]o[>ets have 
not had a diance to play widi it themselves. 

Most developers rely on word of 
mouth and trade magazines for obtaining 
their information. While trade magazines 
are great for getting facts, word of mouth is 
what most people rely tm. Unfortunately, 
word of mouth isn't always as reliable as 
one would hope. 

After seeing these technologies m 
action at WWDC and talking with Apple 
engineers and Evangelists, many of the 
rumors are clearly wrong, tn this article, 
1 hope to trover popular rumors and 
debunk them one by one. 

Display Postscript Is slow 

OPENSTEP uses the Display PosLscript 
model for all drawing. This allows true 
WYSIWIG and easy printing code. OK, 
sounds gcxxl, but aren't there downsides? 
Isn't my Postscript LaserWriter very slow? 


Yes, Postscript used to lie very slow, but was so powerful it 
was worth the wait. Wailing for a high quality printout Is nor as 
painful a.s waiting for the screen to update. When NeXT decided 
Ifj use PostScript for their screen display, Adolx: and NeXT 
realized they would need to improve POsStSexipt's speed. 

*rhe optimizations tliey implemented included using integer 
font meuics for screen fonts, lazy depth promotioas, a)mpression 
of the backing store of a window, txHier algorithms for color 
conversion and dithering, file mapping, and many more. 

So, did this work? In a nutshell, yes^ it worked very well. As 
Apple is proud of saying, Display PfxsLscript is 266 tunes as fast 
as the LaserWriter NT. So, if you I^elieve Apple statistics, and if 
your Li.serWritcr NT can do l6 pages a minute, then you sliould 
lx.' able 10 do 71 frames a second, whic:h ts as fast as tlie inomtor 
can display anyway. It is nice what you can do with statistics, but 
how does it feel? 

To prove diat Display PostScript is ciuile nice, Apple put up 
two windows running different QuickTime movies with a lor of 
motion. During their live demo, they dragged the windows 
around the screen overlapping the two windows; tlie audience 
saw perfea clipping, no sLuucr, no delays. The QuickTime 
movies continued playing as tliey were dragged. Mast Macintosh 
users are used to dragging an oudine of a windtjw instead of a 
window, MacOS drags outlines for speed. Under Rhapsody, 
Display Postscript is fast enough to continue displaying 
QuitikTime movies while fieing dragged. 

Seeing is believing, and 1 saw Display Postscript displaying 
a lot of nice graphics very quickly. 

I need to know postscript to program under Riiapsody 

Rhapsody draws in PostScTipt, and knowing l^osiScript 
would be useful. However, there is a difference ixtween it Ixing 
a good idea to know PostScript and having to know PostScript, 

Ihe vast majority tjf Pc^tScript is hidden from the develo|XT. 
OPENSTEP's framework, called the AppKit, handle's all tlie setup 


Micliaei Rutman is a software developer wiih experience developing for sewemi plailbrnis, including Macintosh, NeXl SlEP, 
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consultant on a variety of projecLs including encTyption, compilers, web based add*-n>tation sc^ftware, and ship stevedoring. To 
contact Michael Rutman .send mail to motxse@iminiuiio{jse.com. 
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Pt)stS<.Ti()t needs for drawinj' or printing views. A tleveloix^r that 
wants to modify tlie default lx;havior would have to knew PostScript. 
l:>nt the vast majority of developers will never need to do this. 

I’lie common PostScript commands — the ones for drawing 
lines, circles, reds, setting (x)lors, anci so on — are wrapped by 
C hi net ions. Drawing a recta nge is done with [VXFillRea( const 
NXIieci *). A developer need only pass a rectangle to lliis routine 
ami the rectangle is drawn. Even though the low level drawing 
is done in PostSc^ript, the develojx^r need only know that there Ls 
a routine that draws a reetange. Tor finer control, 
PSsetcoior(NXColor *) sets ihe drawing color, PSmoveto, 
PSlineto, and FSStroke can do individual lines. 

Almost all entities displayed, such as Ikjxcs, biittons, 
[X)pu[>s, and windows are objects that hide all of die PostScript 
needed for drawing. As long as standard cxintrols are used, no 
Pt)siScripi need be created. Of course, if a cxunplex PostScript 
entity has Lt> lie generated, tlic ctxle can lx* w^ritteil inio a PSw^rap 
and downloaded to the PostScript server, flowever, to do this 
one would have to learn Pn.stScTipt. My expt^riente is that 
pswraps are uKefiil, but rarely necessary. 

My fnond isn’t going to want to learn mtx 

Rhapsody is ba.sed on UNix, fiut wliat does that rntxin? Many 
peofile Ixlicve that omx is a command line itiierface into a file 
system w'here you have \o type grep a lot. NobtKiy wxmts to 
dump this on an unsuspecting oser, and NeXT has worked on 
hiding imx for years. Now that NeXT and A[)[)le are combined, 
there Ls a strong pusli so hide imx even farther. 

How to liide LiNix has always Ix-en trie ky, and early versions 
of IVKXTSTI-.P didn’t dt> a very gixxl jol) of A Heniuse i ixix kept 
peeking u[> iLs ugly head in the early days, there Ls a lot of word 
of mouth hashing of Rha[>sody, and that is unfortunate. Over the 
la.st 8 yeans, NeX'f kis done a gaxi jo!> of pulling the mmx layer 
well under a pleasant user experience. Eveiything your mom am 
do on the Mac can lx* done under Rhapsody in the same way. 

OPHNSTEP, however, Ls for iKjdi yt>ur mom and you. f'or 
power users, OPKNSTEP still has a terminal windovv that 
accesses the UKiX layer directly, and those developers who svanl 
U) can tyjx grep to their hearts amienC If they tion'i w'ani unix, 
tile re are other ways to do wliiit they want to accomplish. Tlie 
UNIX coimiand line is there only for the people that want it. It is 
important to remenilier the (.liffcrcnce between liaving a tool 
available to you, versus having to use a paiticular Ick)) to get your 
job done. RhapstxJy is offering a choice. 

Game devclcipers won’t be able to make their software work 

Game develufxrs program to the hardware, Tlte life of a 
game is measured in months, not years, so working with the next 
system upgrade is a low priority, hut an extra frame a second can 
make or hrc^tk a game, Tn get that extra frame a second, game 
developers need access to the hardware, and the Rhapsody 
framework hides the hardware. 

The Rliapsody engineers imdenitand this problem, and 
they want to play games a,s miieh as the rest of us. 'I'hey have 
[dacetl hfx)ks in at the lowest levels called interceptors. 


Inierceptors allow game develojXTs to write code that accesses 
ihe monitors at the lowest levels, completely l)ypassing 
anything that might slow dt>w'n a game. Game developers that 
need to take over an entire monitor and blit bits around can 
grab the monitor through an interceptor. 

It won’t look like the Macintosh fVe come it» love 

This IS the opinion that is mostly contested. Rhapsfxiy is 
going to kx>k like MacOS 8, not Mac 7.5. 1 low different arc the 
two is still up for debate. MacOS 8 has a more "niodem" look 
and Feel, but it also is still in development as 1 write lliis article. 
Some have argued that the “modern” look and feel Ls unpleasant, 
but it Ls still being cleaned up, s<i it is hard to judge. 

On the other hand, the Macintash lcK>k and feel has been 
evolving since 1984, and current Macintoshes do not kxik much 
like they did 13 years ago. Tlie argument tliat the latest system 
ckx'sn't lcK>k like the Madniosli IVe come to love could have 
lx.*en made years ago, and we would not have a kji of the little 
things dial make ihe Macintosh fun. Color is a good example. 
When Apple added color to the Macintosh, it changed the look 
and feel. Most people now agree thal color was a good change. 

Sot it won’t kxrk like the Macintosh you bought 5 years ago, 
then again, neither will any other Macintosh you buy next yean 
whether it is running Rhup,s(xly or n<H. 

If s not a Macintosh, no niattcr how much it looks like a Mac 

rius is an interesting argument, and it goes along the lines 
of: The Macintosh is what I have on niy desk, and what I’ve 
leameil to program. If you go to unix, and eftange the Too11k>x, 
tlien it isift a Madnujsh. Since it won’t lx* a Macintosh, it won’t 
work like a Macintosli. Since die Macintosh is easy to use, and 
lliis won’t Ixf a Macintosh, it will be hard to use. Believe it or mu, 
Tve haird thai arguuieni from people thal should have known 
belter. Despite all the Haws in the argumeni, it’s an emotional 
fight, and those are always Iricky. 

Tilts is my feeling about whether Rhapsody will be a 
Macintosh. If it looks like a duck, walks like a cluck and quacks 
like a duck, then if’s a duck. In the s;inie vein, if it kK)ks like a 
Macintosh, runs my Mat intosh software, and follows all tiic 
Macintash guklelines. then it’s a Macintosh. 

Now, ril lx* the first to admit, cliange is bad and should noi 
happen, bui in the computer industry, change is inevitai>k\ The 
Macintcksh look anti feel is ev(3lving, and those cliange-S are going 
to effen us. Most of the change>s to the l(K>k ami feel ane atiually 
going lo appetir in MacOS 8, (ccxie named Tem|K)) not Rhapsody. 

Programming Rliapsody is so easy, wc w*on’l need 
pfogramincrs anymore 

in a way, there is a gi^iin of tnith to not needing 
progranmiers. ’Iraditionally, creating a user inierhice required 
cxxle t:hanges, fciach item in each window necxied hard c(xled 
locations. Changing a huuon tide or position could require a 
ccxie change and a recompile. Sonic dialogs could lx edited with 
ResEdii, but ResEdit Ls hardly a coo! for novices. 
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Under Rhapsody, inicrfaces are completely separated from 
the co<le. Kdiiing User Interfaces is done through a program 
called Interface Builder Interface Builder has a lock mode 
where non-prograrnmers can safely make changes to a UI 
without breaking links. On many of my OPENS'PK? 
applications, non-programrners have done the final cleaning up 
of iny user interface files. 

Separating the Ul from the coding usually cuts the need for 
a programmer in lialf This is m»l the same as not neetitng a 
programmer, because someone has to make ihe [program 
useful. 'Ihe graphic: artist can then make tiie [)rogram usable 
without taking up the programmer's time. The reality is thai 
making a software package ustdul as opposed to pretty, still 
needs a prognimmer. 

None of ray Macintosh programs are going to work 
under Rhapsody 

Again, there is a grain of truth here, but not much more tlian 
a grain. Mexst code written to the Toolbox must l>e rewritten to 
take advantage of the new Rhapsody world. Even tliough 
[)rogramraing for Rhapsody ts easier, gening developers to 
rewrite huntlrcds of thousand of lines of code is not likely. 

Transiibns to a new architecture can be painful for users. 
Fortunately, Apple went tlirougli this when they moved from 68K 
machines to PowerPC. Even though few existing applicaticms 
“worked” in the native PPC, the 68K emulator allowed almost all 
existing software to run cm the PPC, even tliough it wasn't native. 
This allowed some people to upgrade, running their software 
without alrandoning all their existing softw^are. Today, some 
applications being shipped wemk only on PPC. 

hi a very similar way, Apple has provided a mode under 
Khapsexiy diat will allow users to run old applications, Currenlly, 
this is called the Blue Box, but over the next 18 months Apple 
marketing may decide on a more user friendly name. 

'The Blue Box has two modes: one puts Blue Box in a 
Rhapsexly window, the other leLs the Blue Box take over tlie 
entire dispby space. In the latter, the machine ksiks and acts like 
a traditional Macintosh, while Rhapsody apfilieations continue to 
nin underneath the UL I'he user exjierience is almost the same 
as a machine ainning MacOS B, but having Rhapsody underneath 
adds stability for Rhapsody applications. 

When Blue Box is nin in a Rhapsody window, all of the Blue 
lk)x applications will put tlieir windows inside the Blue Box 
window. IXliile switching lietween window and full scieen mtxle 
is eiisy, tlic overall experience is ugly. At least it allows users to run 
their one or two Blue Box apps wliile living in a Rhapsody world. 

Rhapsody does not support Undo 

Undo is very difficult to implement, and many a[>plicutions 
sfiend more timt.‘ supporting undo than any oilier feature. NeXT 
got a bad raf> l>ccause none of their existing applications support 
undo, and many early tlevdofiers did not support undo. 

One of the main reasons for the lack of undo was, ironically 
enough, OPENSTEP's ease of devekjpment. Using OPENSTEP, 
tievelopers were able to get a large number of new features 


added to an application very quickly. Unfortunately, undo is still 
difficult. ‘I'his leads u> a developer not wanting to take the extra 
time to add undo for an actk)n where undo can take longer lo 
implement than the feature the developer is adding. 

1 [ow'ever, Apple rc'cognizes that undo is very imjiortanr to 
Macintosh users. Technology for udtling undo has advancetl, and 
adding undo is easier than it was years ago, Tfxiay, die undo 
architecture of Rhapsody allows a quick and easy multipie-level 
undo, once the developer has written undo actions for 
everything tlie user cm do. Writing the individual undo actions 
are going to be as hard as they’ve always bec‘n, but that is true 
regardlejts of the platfonii. 

rlJ need to leam a new' fanguage 

OPENSTHP has used Objective-C for triuny yeais, and the 
framework is designed for access from Ohjective-C. Many years 
ago, NeXT realized that many prognmimers ntnxled to use C++, 
and OPENS'l'EP had to supjxirt C++* Unft>rtunaiely, the C++ 
object model and die Olijective-C object model do not mesh very 
well, and C++ has always lieen a .second class citizen. 

Tlie reason C++ had lo take a Ixick seat i.s lx.-caQSc Objettive- 
C allows nm-iime liinding, and without it, C++ is just not powerful 
enough to fully accass the AppKit widiout using ObjecLjve-C. 
NeXT providetl a way of using lK)th Objective-C and C++ in the 
same routines. This allows a developer to do his l>ack end in C++ 
and his III in Objective-C. Overall, developers were happy, but 
many complained about needing to use mo diftereni languages. 

Then along c.:ame Java. Java is like C++ in syntax, but has the 
ain-time binding diat Objeccive-C nt!cds. Apple found that Java's 
object model is very close to the Objective-C object mcHlcl, atid 
set up the Java Virtual machine to allow code written in Java to 
access the Objective-C framework directly. Even though the 
developer coding in Java is calling Objective-C cibjccts, 
everything is transparent. For the Java developer, programming 
the AppKit is dt>nc entirely in Java. At least that’s the theory, I 
haven’t had a chance to try it myself. 

Once the decision was made to allow the Java developer to 
access the AppKit directly, the next logical step was to make 
Objecrive-C more like Java. Having developed in ObjecLive-C for 
many years, 1, personally, do not see why develo[x?rs would 
want a Java syntax, hut most developers I’vu talked to have made 
it clear that they would rather use the Java syntax than die 
Objective-C syntax. Both are supported, so old lime developers 
can exmtinue to use the old syni;tx, and new developers only 
have to know die syntax of Java. 

Now, die new Olijectrve-C synUix may have a javadike syntax, 
liut it isn’t Java. IPs si ill 01>jeciive-C. which means you still have all 
the power of C. One advantage is tliat developers t:an juiiip 
fx:twcen C++, Java and Objective-C as the need arrives, laking a 
C++ lihniry, hooking it up to some Java nelworkiiig code, and 
thiowing on an Olijective-C interfatre Ls easy, and each language 
t:an directly access any of the otliers. With the new synuix for 
Objective^, everything will liave roughly the same Icxrk. 
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lil need all new drivers for my hardware 

Yes and no. One of the goals of Rhapsody Is tnaklng [he 
drivers more standard. SCSI drivers, for example, have always 
been a problem on the Macintosh. Personally^ 1 have 3 different 
drivers for removable media, and none is cornpalilile with any 
of the otliers. Under Rhapsody, I don't need special drivers for 
most SCSI hardware. It would lye nice if all drivers worked this 
way, unfcjiiunately, not all drivers will work and those drivers 
must be updated. 

Because Apple recognizes that their users will need to 
continue using their existing devices, Rhapsody has a dual boot 
mechanism. The Macintosh can be booted into Rliapsixly and 
run the Blue box, but if a device Is only going to work under 
traditional Macintosh, then the machine can be rebooted to run 
the traditional Macintash OS. In this mode, Rhapsody won't be 
running at all — all old drivers should then work. 

Fortunately, the new driver kit makes writing drivers easier. 
Apple knows that Rhapsody will only succeed if users can use their 
devices, and Apple is working with developers to make sure they 
are using the new driver kit. Developers shtnilci be happy with the 
new driver kit as it will cut development time drairatically, 

Apple's abandoning ail these c(k>1 technologies 

First, Apple has not abandoned die technologies we have 
come to rely on. They have put some of their technologies in 
maintenance mode, which means there aren’t going to be any 
wizzy new features added to it. Some hug fixes, and system 
upgrades will still happen. 

One example of an ’"abandoned” technology is OpenDcx:. 
The rumors are that nolx)dy is working on OpenDoc, and all 
developers that committed to it arc now i>ut of business. ITie 
reality is that OpenDoc has been ported to MacOS 8, and us 
already running on the Blue Box under Rhapsody. All existing 
OpenDoc parts will run under Rliapsody in the Blue Box. 

Furthermore, even though Apple has no announced plans to 
port OpenDoc to lye a native Rhapsody application, Apple is not 
stupid. If a market appears for OpenDcx: part.s, Apple still has all 
tlic sourec ccxie, and they still have engineers dtat know tlie 
internals of OpenDcx:. If Apple finds out that another technology 
they created is taking off and Ijccommg an industry standard, J 
would expect Apple to jump right back in. Developers that have 
committed to OpenDtx: may not have the huge market they were 
hoping for, but if they can create the market, Apple will be right 
back on board Now, that's just my opinion, and it is unlikely that 
Apple will comment one way or another, but I think it's a safe 
hei that Apple will do what's in their be.st interest. 

jusUfic-ation of this opinion, however, can lx; seen in Game 
Sprockets. Less than 2 months ago, it was announced tliat 
Game Sprockets would be in maintenance mode. By WWDC, 
Apple was shown that Game Sprockets i,s an emerging 
standard, will help sell machines, and is just a generally good 
idea to have. Game Sprockets are back in development, and are 
being ported to Idiapsody. 


Whatever Apple announces at WWDC is dead in a year 

In the past, Apple has shown developers new technologies 
as early as possible, and the developers helped shape each 
technology. By the time the tecluiologies were ready for users, 
the technologies often had very little in common with what 
Apple first presented. Occasionally, once liie technology had 
been hashed out with developers, Apple realized lliat it may lx: 
cool, but notxxly in die market cares. They would then cancel 
the technology, and die devclopeis that wanted to use the 
teclmt>logy were, justifiably, upset. 

This year, therc^ is a difference. Apple is not showing us 
technology in its infancy, but technology that has been ported to 
several platforms and used for many years. The main thrust of 
WW13C was Rhapsexly and how all the other parts of Apple will 
fit into Rhapsody. Some of die technologies Apple showed at 
WWDC are in their infancy, and I would expect changes in those 
technologies, and I would not be surprised if a few of the diings 
1 heard never saw die light of day. Rhapsody, fortunately, is 
unlikely to be canceled, 

Macintosh Developers have abandoned the Mac and are 
all developing Windows apps 

Every year 1 hear this, and every year 1 kK>k around and see 
diousands of Macintosh developers. True, there are many 
developers that have moved to WintJows, and a lot that have 
moveti to Java, but there are also many new Macintosh 
[:)rograrTimers. WWDC had almost 2000 developers, and lliat’.s 
almost as many as they had last year. Of course, last year, there 
were addidonal developers diat only attended for one or two 
days, so it's harder to compare. 

Companies, however, have had to make a business 
decision. Many companies la.si year announced a wait and see 
attitude on the Macintosh. Some companies even downsized 
their Macintosh departments. 'Ihe good news is that otlicr 
companies jumped into the market to fiD the void created by 
those companies jumping ship. 

Interestingly enough, some of the companies that 
downsized their Macintosh departments have been struggling to 
rehire Macintosh programmers, u.sua[ly at a higher rate than 
they were paying. It turns out that 27 million Macintosh users 
world-wide have a large influence on purchasing software. 
Companies that thought the Mac market was dead have had to 
get back into the market quickly to meet the demand that 
Macintosh users are creating. 

Apple has lost market share 

Yes, Apjde lias lost market share, but the Mac08 has gained 
market share in the last year. Tlie clone makers have taken over 
a major t^himk of the Macinto.sh market. Some have worried that 
the clone makers arc cannibalizing Apple's share, and this has 
happened to some degree, l>ut they have also helped Apple 
expand the market. In reality, Apple Im seen the market share 
of the MacOS gniw by 11%. 
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Apple engineers are all depressed and looking to quit 

When Apple laid off over 4000 employees and contrac:lors, 
ihe mood ar Apple was less thin happy. However, like all good 
programmers, once they had an ohjective, tlieir focus and 
happiness returned. Just about every Apple engineer is extiied 
alXDUt their new system, and all of them are happy to spread the 
word. They are cranking out Hhapsexly in record time, and at 
WWIX, they raced to gel their latest ereacions into the shi3W. 
Every engineer that talked was excited about both Rhapsody as 
a whole, and tlicir individual efforts. 

Apple always talks Pie in the Sky and promises a lot 

Yes, they do. This time, for a change, From the CEO on 
down, lire goal was to under promise and ewer deliver On this, 
tltey did a great job. Several times, a developer would 
recommend an improvement, and almost every time the answer 
was, '^That's great, we wani to do it, but right now, this is what 
we have to deliver Maybe next year." After having gotten used 
to a company that has, more often than not, bitten olT more 
than it can chew, it was wonderful seeing a team that could stay 
focused on what they are working on and leave the dream 
solution for later day. 

This is not to say that Apple did not recognize developer 
concems, quite the opposite. When a developer brought up a 
point, the Apple engineers coasidered it, and where they could, 
they talked alx>ui liow a developer would deal with that 
problem. In some cases, Apple agreed lo make changes, in 
Olliers, Apple explained why they imde the decisions they did. 
■Jhey have a lot of bright people working on these problems, and 
they have a lot of open minds. 

The most refreshing pan, by far, was the Apple engineers 
admitting that they can deliver a very good system witliout it 
being the end-all system. They admit that there will lx: problems 
to \yG worked out, but that won’t .stop iliem from delivering a 
good system in a reasonable time frame, 'llie best part, most 
developers understcxxl and respected Apple engineers when 
they said "^Not this year,'' 

How Do 1 Feel Aboih Things? 

ril admit lliat 1 was pretty ext:ited alx)ut Apple merging with 
NeXT before WWDC, but what I got was better than 1 could have 
ever hoped. \ had l>een afraid that Apple engineers were 
dejected, NeXT engineers would gloat, and nobody would know 
what they were going to deliver. Instead, 1 saw Apple and NeXT 
engineers working together, everyone excited, and some pretty 
c:(X)l stuff Ixing developed. 

If you weren't there, you wouldn’t have seen the glow in 
the engineer's eyes when they had the MacOS (Blue Box) 
running on Rhapsody, You wouldn't have known that they feel 
they are creating something special. Most of all, you wouldn't 
have seen a management team listening to the developers, and 
taking notes to suggestions. Hi 


Viewpoint, continued from page 4 

much of the user interface code is already written, we developers 
are free to ship sooner or spend time adding more fetitures. 

StiU Some Holes in Rhapsody 

Rhapsody is not all j>eaches and cream, There are some holes; 
the p<xjr networking support Ls the biggest. lietween Apple's 
pjesentations and my cronversaiions in tlie halls of WWDC, it is 
dear that Apple still dtxrsn'l understand how the Inlemet Ls 
changing; their “Hinttegy” Ls limited tc^ web a)nieni development 
and deployment. ‘Ibey seem to be ignoring many other areas 
including communic:atitms, collalx>miion and commerce. For 
example, Yellow Box does not provide any foundation classes for 
using common Internet protocols suc:h as HTTP or FIT. It doesn't 
even provide a foundation class for basic IP networking. Tills 
means that every network-sawy Yellow [kix applic:ati<jn must use 
piatform-sf>ecific network code. A Kfiaps^xiy application will use 
Rliapsody's version of BSD scxrkcts, a MacOS application will use 
Open'rransport streaias and a Wintel application will use WinStxk. 
Given tliat networking is the fastest growing segment of the 
.software industry, it seems absurd tliai Apple does not provitle a 
network abstraction layer in Yellow Box as they have for ihe user 
interface. 

This networking issue also raises tlie question of why Apple 
is using sockets instead of streams. Everyone 1 spoke with Im 
made a strong aigumem for streams being a more flexible and 
generally superior architecture. Wfien Apj>!e asked us all to move 
our network code to OpenTransport (streams), they said it was a 
technology for tlie furture. Streams provides .standard APIs at all 
levels, allowing developers to write ctxle to adjust the contents 
of the network at the level that makes sense for their software. 
Some developers argued that Apple should develop a sockets 
interface to make porting code to fXher platforms easier. Apple 
answered that sockets could easily be implemented on top of 
streams, and some third parties offered libraries doing exactly 
that, ll is very hard to go the other way Ix^cause sockets 
implementations really define only the highest level API. The 
underpinings are specific to each platform. 

Not only is it odd that Apple seems to liave ignored their 
original reasons for moving all developers to a streams 
iniplementation, but Apple already has most of the stream,s code 
for Khapsexly, including complete network ,stack.s for AppleTalk, 
IP, IPX, and TokenTalk. Instead, they are jx^rting the NeXTSTEP 
sockets code and adding the ADC AppleTalk sockets cxhIc; then 
they have to find a way to make Blue Box's OpenTransport 
(streams) work on top of this. Many WWDC attendees asked 
Apple how they intended to solve specific, difficult prolilcms 
with this sernario. Apple's most common aaswer was “Ilm, we 
hadn't tlioughi of that. 'ITiat's is a hard problem, but we're sure 
we can solve it when we get to it.'' To Apple's credit, tliey 
repeatedly uxik some harsh critism from attendees, and they 
appeared to really listen. Hopefully they got the mesage that they 
should reevaluate the ledinical merits of choosing s<K:keis over 
streams so we can have a networking architetiure that can grow 
with the rest of the platform. B 
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PROGRAMMER'S 

CHALLENGE 


I’yy Boh Boonslra, Wastforci, MA 



Disambigijator 

Tht^ Chnlienge this month is u> write n string completion 
routine loosely piiLlernecl after the keyword lookup fucilily in the 
QuickView' utility, QuickView will stiggest a completion of the 
keyword as you Ix^gin to type it, and upckiie that suggested 
completion as yoti continue to type. In llic TtK)ll>ox Assistant, 
for example, if you are l(K)king for documentation on InilGraf 
and type “i'’, the suggested completion is “iconlD'lViRgn", As you 
continue by typing the suggestion Incomes “index2Color''. 
Adding "i” yields "iniiAllPacks"; adding "t" leaves tiie suggestion 
intact; adding “g" changes it to “inirGDevice''. FiiiLdly, typing “r” 
gives the desired “initgraf. 

For <Hjr disambiguator, you will be given an unsorted list 
of words and an op[)ortuniiy to preprocess iheiii. Tlien you 
will lx given a .siring to inaidi and asked to return a list of 
words matching findSlring. To make the problem more 
interesting, tlie match string can contain wild card characters, 
as described below. 

Tlie prototype for the code you should write is: 


lyp^def unsigned long ulong; 

void InitDisanibigiiator ( 

conar ohar 'const wordLlst[]. 
ulong miraWordi;. 
void 'privStorage, 
ulong ETorageSise 


ulong /'numMatch*/ Dlfsa(iiblgU0tor 
const char 'const wordbist[], 
uloiig numWords- 
void 'prlvStorage. 
nlong EtarageSize, 
char 'findString, 
dtar *HiaT:chList n 

); 


r ^unb to match againsi V 
r number of wtmts in worxilist 7 
r pfivare storage pnntiiTiali7xU to jxto 7 
/* number of bytes n( privSlonigc 7 


/' words to miuch ag;iinst 7 
/' numbtT of wonb in wordlist 7 
/* private storage 7 
r number of bytes of privStorage V 
/' string to match. inOudes wild curds 7 
t return matched words here 7 


Your InitOisambiguator routine will be called with an 
unsorled li.si wondUsT of numWords null-tenninaied words to 
match. The word List words will include alphanumeric characters, 
spaceSj and imderscores. You will also be provided with a 
pointer privStorage to storageSize bytes of (>reall(X'ated memory 
initialized to zero. The amount of storage providcxl will Ik: at 
least 20 bytes for c^ach word in wordUst, plus one byte for each 
charaaer in the wordList (including die null liyie, and rounded up 
to a multiple of 4), In other words, storageSize will l>e no smaller 
tlian minStorage, calculaietl as: 

for (minStoragc?=0,i=0; iCnujaWorde: i+-t) 

mlnStorEgc +“ 20 + ^ * (i'*‘3trlen (wordLifJt f i] ]/4); 

InitOisambiguator Is tkA allowed to mexlify the wordUsl, but 
you may store a .sorted version of wordList. or pointers to the 
words in sorted oftier, in privStorage. The first four parameters 
provided to Disambtgualof will be identical as those provided to 
IniOsambiguator, In addition, you will he provided with the nuQ- 
tcnninaied findStfing and a preallocatcd array matchList with 
numWords entries where you are to store pointers to the words 
float match findString. Ytjur siring matches should be c'ase 
iasensiiive (i.e., “initgr" matches “InitCrar. The matchList should 
lx reiyrned with the springs ordercxl in casc-inscnsiiive ASCII 
order (i.e,, space < 10. 91 < [A-Za-z] < underscore). 

Hie findString may also cuntain zero r^r more of the wildcard 
cliaraclLTs and *4'. The wildcard “?' matches any single 

chaiaaer, matches zero or more characters, and '+’ matches 
one or more characters. So, for example, ‘“graf” matches any 
siring ending in the Cease-insensitive) siring "^graF', while 
''+nnd+" matches any string containing “llnd'' Ixtwccn the first 
anil last characters of a wt}rd. 


THE RULES 


Here's how ii worki^: eacb month we present n new programming 
challenge* First, write some code that solves the challenge. Second, ojjiimixe 
your ctxJe (a lot). Oien, subnirr your solution to MiuTech Magazine. We 
choose a winner ha-sctl on code correctness, speed, size, and elegance (in 
ihaL order of impommce) as well as ihe suhmisEion dare. In ihc event of 
multiple equally de.Strahle solutions, wc'II choose one winner (with 
honorable mention, but no prize, given to the runner upj. Tlie prize for each 
montlVs best solution is a SKK) credit for Developer Depot™. 

Unless staled otherwise in the problem statement, die following rules apply 
All solulicsns must be in ANSI compatible C or €++, or in Pad'll!. We disqualify 
eniries with any assembly in them (exeqx Tejc challengra specifically stating 
otherwise.) You may call any Macintosh Tixilb^jx foininc (e g., it doesn't nianer if 
you use NewPtr iasiead of midlix:). We compile atl entries Into native PowerPC 
lYKle With conipikT .set to trnable all availal^c .s|xvtl ijfXimizations. nie 

developn>eni environment to he used for selecting die winner will lie .'italed in the 
lirubleJiL Limit your code to 6o cJiaracters per line or compress ami Ixnhex the 


solution; this helps with e-mail gateways iuid piige layout. 

We publish die solution and winners for eadi month's Ffogramme/s 
Challenge three nionili.s later AH submissions must be received the 1st day 
of the month printed on the front cover of this issue. 

You can get a head start on the Cliallenge by reading die l^rogrammePs 
CliaJJenge mailing list. It will be posted to the list on or liefore the I2ih of die 
preceding month. To fojn, send an email to Ii.st,serv®listmail.xplaln.com with 
the subject ‘"subscribe challenge A". 

Mark solutions "Alt!!: Programmer's Challenge Solution'* and send it by 
e mail to one of die Programmers Challenge acldresses in the “How to 
Communicate With Hs** section on page 2 of this is.sue. Include the stiluiion, 
all related files, and your contact info. 

MacTcch Magazine reserves die right to publish any solution entered in 
the Programmer's Challenge. Authors grant MaeTech Magazine the exclusive 
right to pul>ti$h entries wiiiioul limitation upi>n submission of each entry. 
Authors retain copyrights for the code 
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For e!iich ciill to fnitDisambiguator, your Disambiguator 
routine will be called an average of lUQ to 1000 times. The 
winner will be the solution that finds the correct match List in 
the minimum amount of time, including the lime taken iiy ttie 
initiali/aiion rouiine- 

't'his will he a native PowerPC ChaUenge, using the latest 
Code Warrior environment. Solutions may be coded in C, C++^ or 
Pa.sc:aL Tlve prol)leni is Ijased on a suggestion l>y Cliarles 
Kehiuver, who pointed me to an April, 1995, AppieDireclions 
article disaissing the user interface lV>r a dfsambiguaton Charles 
wins 2 Challenge points for his .suggestion. 

TftREK Months Ago Winner 

Congratiilalions io ACC Murphy (Penh, Australia), for 
submitting the bister (and smaller) of the two entries J received 
for tlie Projection Challenge, f'his problem required contestants 
to calculate the image of a set of input polygons, intiuding the 
shadows cast by one polygon on another, given ao observation 
viewjxjint and an illumination [X^int. 

both of the submitted solutions u.sed a ray-tracing 
Leclink|ue. The winning solution calculates, for each point on 
the projection plane, the nearest polygon to the viewpoint 
among those intersecting the ray from the plane to the 
viewpoint. It then does anotfier ray-trace io determine if there 
are any other ptdygons l>etween the illuniination point and the 
projected polygon, identifying the point as being in shadow if 
an intervening polygon is found. 

f ran three Lest cases, moving the [lolygons 10 litnes for a 
given viewpoint in each case, using a GWorld bounds rectangle 
slightly smellier than my 1024x768 m<)nitor. As yi>u can see from 
the? execution Unites, considerable refinement would be needed 
before this cotle could l>e used for animation, 

A good discussion of the projection and hidden surface 
removal algorithms applicable to this prolilcm can be found in 
the Black Art of Macinlosb Game Programming, by Kevin 
Tieskoetter. In addition to discussing the z-huffer ray-tracing 
algorithm, it describes another technique for hidden surface 
removal trailed the Painter’s algoritlim. Tliis approaelt breaks 
the polygons to he displayed into [Pieces such that each piece 
is entirely in front of or entirely behind any other piece, as 
seen from the viewpoint. The polygons can then be sorted and 
displayed without looking at each pixel in die image. For our 
application, two polygon decompositions would be required, 
one for the image, and one for the shatlows. 

The table l)ck>w lists, for each entry, the execution time for 
each case and the code size. The number in parentheses after 
the entrant’s name is the total number of Challenge points 
earned in all Cliallcnges to date prior io tliis one. 


Top 20 Contestants 

Here are the Top Cr>ntestant.s for the Programmers 
Challenge. The numbers IxjIow include points awarded over 
the 24 most recent contests, including points earned by this 
montlVs entranLs. 


Rank Name Points 

Rank 

Name Points 

1. 

Munter, Ernst 

194 

IF 

Beith, Gary 

24 

2. 


114 

12. 

Culls, Kevin 

21 

3. 

CtK:i|KT, Greg 

54 

13. 

Nicx>lle, Ludovic 

21 

4, 

Larsson, Gustav 

47 

14. 

Picao, Miguel Cruz 

21 

5. 

l.engyek Eric 

40 

15- 

Brown, Jotg 

20 

6. 

lk)nng, Randy 

37 

16. 

Gundrum, Eric 

20 

7. 

Mallftt, Jyff 

37 

17. 

Higgins, Charles 

20 

8. 

Lewis, Peter 

32 

IS. 

Kasparian, Raffi 

20 

9. 

Murphy, ACC 

30 

19. 

Slezak, Ken 

20 

10. 

Anloniewicz, Andy 

24 

20. 

Studer, Thomas 

20 





Create bar codes m any windows or 
Macintosh program quickly & easily 
with Rivers Edge bar code fonts. 




TrueType & Postscript Fonts ,. 
Easy to Use . 

30 Day Money-Back Guarantee 

$t43H 

Choose from: ' 

Code 19, Cede 93, Cede 128. ' - 
Int. 2 el 9, Cedabai; MSI-Piessey, 
PestKGt, UPC/EAN/tSSN 




!, V * 


: ’ Attaches to Keyboard 
Plug & Play tor Windows/Mac 
' Easy to Use : 

gzza - Wand Reader-Basic 
S295 - CCD Rpader 
W95-Laser Reader 






Casel Case 2 Case} Total Code 
Name Time lime lime Time (secs) Si/x 

A.C.C. Murphy (10) 29.02 23.64 81.61 ImIt 41% 

Ernst Munter (232) 20.87 58.11 89.76 l6a74 7192 
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There are rhree ways to earn points: (1) scoring In the top 5 
of any Challenge, (2) Ix^ing the first person to find a bug in a 
published winning solution or, (3) being the first person to 
suggest a Challenge that I use. The points you can win are: 

1st place*.,.....20 points 5di place ......2 points 

2nd place points finding bug . .,,2 points 

3rd place J points suggesting Challenge ..2 points 

4th place.,,4 points 

Here is A.C.C. Murphy's winning solution: 

Challenge.p 
A,C.C, Murphy 

unit Challenge; 

c 

Assumpdons: 

Stuntgc space must be bij; cnougli for 13 floats per polygon 
All poinis must bo significant]}' smaller in magniiutk ilian lllG_FLOAr = 
1000000.0 

Ptilygon.-; are translucent (tfieir colour b3.scd uplon lightini; is independent uf the 
side of the polygon that is lit) 

50»& anenuation of colour is used 
50% aEtcDuatioii of black is black 

Method; 

TnitProjection Ls not used 

First we precalculate a small bounding sphere for the polygon points. 

Next we get the information about the GWorld to allow dijitct pixel access, 

Tlicn for each point on the GWorld, wc trace the lay from the point to the eye, 
intersecting it witii each polygon and finding the one closes to the eye 
(ftinhesL forward, since the eye is infront of all polygons). Ifiat deiermines 
the colour. We then trace the ray from that intersectitm point to the light 
source to determine whether the point is in shadow, and if so wc halve the 
intensity. We set the colour of the pixel and move on. 

Optimizations: 

Direct pixel access to the GWorld tknown to be 32 bit) 

Bounding sphere used to optimize the ray/polygun intersection lest. 

Time is approximately 2 micnjseconds per pixel per polygon on an B5(M). 

interface 

uses 

Types, Quickdraw, QDOffscreen; 
const 

kmPOim - 10: 
const 

BIC^FLOAT = lUOOOOO.O; 
type 

float “ real; 
type 

My^DPoint ” record (* 

x2D: float; Cx coordinate*) 
y2D: float; C y coordinate*} 
end; 

MySDPoint ^ record 
xlD: float; 
y3D: float; 
z3I): float; 
end; 

My3DDirection = record 
thetaX:float; 
thetaY;float; 


thetaK: float: C angle in radians*) 

end; 

MyPlane - record 

pi aneNorraal: NyJDDi recti on; (* normal vector to plane*) 

planeOrigin; MylDPoint; (* origin of plane in 3D space*) 

end; 

MyPolygon = record 

numP oinLs: longlnt; (* mimhcr of points i n polygon*) 

thePoint: array [0, .kHAXPOTNTS l] of Hy?.DPoinr; 

(* [xyl^on in z=0 plane*) 

poly Plane: Hy Plane: C* rotatcAmnslaic z==0 plane to this piane*) 

polyColor: RGBColor; <* the color to draw' this polygon*) 

end: 

MyPolygonArray = atrayr0..0l of MyPolygon; 


procedure XnilProjectlonC 

const viewpoint; My3DPolnt: C viCwpoinT from which to project*) 
const illumPoint :My3DPoint ;(* viewpohn from which to draw^ shadow*} 
storage: univ Ptr: (* auxUiar}'storage prcallocated for your use*) 

storageSlze; longint (* number of bytes of storage*) 


procedure CalcProJection( 

offscreen: GWor IdP t r r C GWorld to draw prt^jection *) 

const thePolys: HyPoiygonArray :<* polygons to project *) 
nuniFolys: 1 ongint: (* number of polygons to project *> 

const viewpoint: Hy3EPoint: (* viewpoint from whidi to project *) 

const illumPoint: My3DFoint: 

f illumination point Irom which to draw shadow *} 
storage; univ Ptr: C '^lT pneallocatcd for your use*) 

s t orageSize; Ion gj nt (" number of byte.*? of storage*) 


implementation 

type 

Ray3D = record 

origin: MyBDPoint; 
direction: My3DPoint; 

end: 

PolygonExtra = record 

normal, rotX, rotY. center: MylDPoint: 
radius2: float; 

end: 

PolygonExtraArray = array[0,,0] of PolygonExtra; 

StorageRecord = record 

po1y_extra: PolygonExt raAr ray: 

{ must be at the end, since it's an extensible array } 

end; 

StorageRecordPtr = *StorageRecord; 

funclion OoLProduct(const srcl, src2 ; My3DPolnt) ; float: 
begin 

DotProduct := srcl.x3E*src2.x3D + 

srcl.y3D*src2,y3D + 
srcl.z3D*src2,z3D: 

end: 


CrossProduct 

procedure CrossProduct(srcl. src2 : My3DPolnt: 

var dst : My3DPolnt); 

begin 

dEt,x3D srcl ,y3D*src2,z3C srcl,z3D*src2.y3D; 
dst/ylD ;* srcl.x3D*src2.x3D - srcl.x3D‘Erc2.z3D; 
dst.zlD srcl.x3D*arc2.y3D * srcl.y3D*src2.x3D: 
end; 


AddVectofH 

procedure Addyectors(const srcl, src 2 : My 30 Polnt: 

var dst : KylDPoinL); 

begin 

dBt,x3D srcl.x3D + src2,x3D: 

dfit.ylD := srcl .y3D i .‘jrc2.y3D: 

dsl,z3D ;= srcl.ziD + src2.z3I): 

end: 


C X etjordinate*) 
C y ciMirdinatc*) 
C coordinate*) 


(* angle in radiaas*) 
(* angle in radians*) 
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SabiractVcctur^ 

procedure SubtractVectots(const srcl< src2 2 My3DPolnts 

var dst : My3DPoint): 

begin 

dst.x3D := srrl.x3D - src2.x3D: 

dst*y30 srcl.y3D srcZ.y3D: 

ds(..ii3D i;rcl.K3D src2»?JD; 

end ; 


MidPtiiiU 

procedure Midpoint( const srclt src2 : Hy3DPotnt; 

var dst : MySDPoint): 

begin 

dst,x3D {srcI,x3D + src2.x3D) / 2; 

(]st*y3D := {£:rci-y3D + src2.y3D) / 2; 

dst*si3D (srcl.z3D + src2.z3D) / 2; 

end ; 


DbtanctZ 

function Difitance2( const srcl, src2 : My30Point) : float; 
begin 

Dlsianco2 uqr(srcl*x3D - E;rc2*K3D) + 

sqr(srcl,y3D src2.y3n) + 
sqr(arcl.z3D src2.z3C): 

end : 

ScafcVcctcir 

procedure ScaleVector(const arc ; My3DPoint; scale : float; 

var dst : My3DPoint): 

begin 

dst,x3D sce.x3D * scale; 

dst»y3D src-y3D * scale; 

dst.z3D ;= src-z3D scale; 

end; 


NormalircVcaqr 

procedure NormallzeV'ector(const src : My3DPoint: 

var dst : My3DPoint); 
var 

length : float: 
begin 

length := sqrt(DotProduct[src,src)); 
dst,x3D ;= arc.x3D / length; 

dst.ylD ;= src.ylD / length; 

dst,z3D := src-z3D / length; 

end; 


MakeVien'Ray 

procedure MakeViewRay(const eye r MySCPoint; 

K. Y* 2 ; float: var ray ; KaySD): 

begin 

ray.origin.xBD x: 

ray,origin.y3D := y: 

ray.origin.z3D ;= z: 

ray.direction.x3D eye.x3D - x; 

ray.direction,ySD eye.y3D - y: 

ray .direction *2 313 eye.zlD - z; 

NormalizeVector[ray.direction, ray.direction): 
end; 


RotateX 

procedure RutateX{Hrc : My3DPoiiit; siiiA, cosA : float; 

var dst : HyiDPoint): 

begin 

dst.x3D := src.x3D: 

dst.ySD ;= cosA*Erc.y3D - sinA*src,z3D: 
dBt.z3D ainA*.'^ r<i.ylD 1 cosA'src. z3D ; 
end : 


RotaicY 

procedure RotateY( src ; HylDPoint; sinA, cosA : float; 

var dst : MylDPoint); 

begin 

dst.x3D cosA“src.x3D I sinA'src.z3D; 

dst.yBD src.ylO; 

dst.£:3B sinA'src .x3J> + cosA'src*z30; 

end: 


for the Macintosh- 

The Industry Standard for 3D Graphics 

^ Port your code from other platforms with ease! 

^ Workstation Class Performance on your Mac 
^ Complete on-line documentation and support 
Alt common support libraries provided 
^ Multi-processor capable 
^ UNIX or MKLinux versions 
^ Works with most compilers, including CodeWarrioi® 
^ Callable from C/ C+-(-, Ada and FORTRAN 
^ Full Technical Support 
^ Custom Libraries available 

Conix Graphics 

Download free demos at: 

www.conix3d.com 

Let your imagination fly! 


Sates Technical FAX 

800.577.5505 817.467.0461 817.467.9452 

sales@conix3d.com 

All tradefnar*ts penialn lh® properly erf tfieir iBspectlvo cwwrs. 



RoUttZ 

procedure RotateZf sre : My3DPoint: slnA. cosA : float; 

var dst : MylDPoint): 

begin 

dst.x3D i- cosA’Brc.xlD - sinA^sre *y3D : 
dst.ySD sinA‘src.x3D + cosA*src.y3D; 
dst.zlD := src,z3D; 
end: 


Poi ntlnPlanc I ePtdygon 

lunctiuii PoinLlnPlaneXuPolygonC coesL pt: My^nPolnt; const 
poly: MyPolygon ): boolean; 

function Quadrant( const pt; My2DPoint: x, y: float }: 

iongint: 

begin 

if pt.x2D > X then begin 
if pt.y2l> > y then begin 
Quadrani 0; 

end else begin 
Quadrant 3; 

end: 

end else begin 

if pt.y2D > y then begin 
Quadrant := 1; 
end else begin 
Quadrani 2: 

end: 

end: 

end: 
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fmictioii 3t_intercept ( const ptl, pt2: My2DPoint* 

yy: float ): 

float; 
n 

x_ltiLcrccpL := pL2,x2D 

( (pt2.y2D yy) * 

{{ptl,x2D pt2,x2D)/(ptl.yZD pt2.y2D)) 

end: 


vat 

1, angle< quad, next quad, delta: longint: 

1 a st_vertex, tiext^vertex: My2EPoint: 
begin 

angle 0; 

last_vartex poly .theFoint [poly .nuniFoints-l] : 
quad := Quadrant( iast^vertex. pt.x2D* pt.y2D ); 
for i := 1 to poly.numPoints do begin 
next_vertex poly.thePointli-i]: 

next quad Quadrant( next vertex, pt.x2D* pt.y2D ); 
delta := next_qnfld - quad: 
case delta of 
3: delta := Ir 
3: delta 1: 

2. -2: begin 

if x_intercept( last_vertex» next_vertex, pt.y2D ) 
> 


pt.x2D then begin 

delta := -delta; 
end: 
end: 

otherwisse begin 
end: 
end: 

angle := angle ^ delta: 
quad := next^qiiad; 
lafli_vetlox := nexL_vertex: 
end: 

PointlnPianelnPolygon := (angle = | (angle = -4): 

end: 


inttrrsett 

fuEicLion Intersect (const ray; RaySD: const poly: MyPolygon; 
oorisi poly_cxtru; Polygonl^xtrut var dislaiHO : float: 
var interaectionPt: MylDPoint] : boolean; 
var 

tempVector : My3DPoint: 
tempi. tenip2 : float: 

1 n ter fleet 1 onPoint ; Hy3DFointi 
lnicrsoction20 : My2DPolnL; 
lb. ic. Id: float: 
begin 

Intersect false: 

{ micmci my with ^^phcrc [ 

SubtractVertrtrK( ray.origin, pnly_e3<tra.renter. 

tcmpVoctor ): 

Ib 2 * l)otProduci( ray .direction. ieropVet:tor ): 

Ic 1 “ DotFro'duct( tempVector. teiapVector ) 

poly_extra. rad.lua2: 

Id sqr(Ib) ' 4.0*Ic; 

if Id 0 then begin | yes, my imcrsecLS sphere ) 

tempi DotPtoduetC poly.polyPlane.planeOrigin. 

poly_extra.normal ) - 

DotProducU poly_exira,normal, ray.origin ): 
temp2 DotProduct{ray.direction. poly^extra.normal3 : 
if temp2 <> 0 then begin 
distance tempi / temp2: 
if distance > 0 then begin 

ScaleVector(ray.direction. distance. 
intersect ionPoint); 

AddVcctorsdnLersocilouPoiril. ray .origi n. 
intersectionPoint); 

if Distance2{intersectionPoint, poiy_extra.center) 

poly extra.radiua2 then begin 
i inierMEciion fXiint is whithin sphere. 

Find out if it is iktlmlly in the polygon | 
iiitGrSGctionPt inteisectionPoiot: 

( First tnnslaic hack to the origin | 

SubtractVectors(intersectionPoint. 

poly.polyPlane,planeOrigin.intersectionPoint); 


intersectionZD.x2D DotProduct( 
intersectionPoint. 
poiy_extra.rotX ); 
intereection2D.y2D := DotProduct( 
IntersectionPoint, 


pol y_ext ra.ro L Y 3: 

(Then check if it is whithin the polygon} 
intersect := Point I nP lane InPolygon 

(intersectiouZD,poIy); 


end: 
end; 
end: 
end: 
end: 


InitProjoction 

procedure liiitProjectiont 

const viewpoint: My3EPoint; C viewpoint from which to project *) 
const lllumPoint:Hy3EPoint: 

r viewpoint from which to draw sljudow ') 
storage: univ Ptr; C auxiliary :itt>raf*e pmlltXTiled for your use *) 

storageKixe: louglnt (* number of bytes of storage •) 

): 

begin 

|$unused( viewPolnt. lllumPoint* storage. storageSlxe )) 
end; 


PreparsePolygons 

procedure PreparsePolygons( iiiy_storage: StorageRecordFtr: 
ruimPolys; longint; const thePplysj MyPolygonArray ); 
var 

i, j : longint: 
pt: MylEPoint; 

pts! arrayil-.kMAXPOINTSl of HyJEPoint; 
min X. min_y. tniti_x, max_x. max_y. jEax_z: MylDPoint: 
diat_x. dlst_y. dlst_x, new radius2: float: 
radius, new r.^diup, old_to new: float; 
sinX* cosX. slnY. cosY* sin?-, cos?: float: 
begin 

for i ;= 0 to numPolys-l do begin 

with niy_3torage^ .poIy_extralil. thePolysLiJ* 
polyPlane.planetlotmal do begin 
sinX := fti nfthetaX) : 
cusX cof!(i hetaX); 
sinY ;= sinClheLaY): 
cosY := cosCtbetaY): 
sinZ := sin(thetaZ3: 
cosZ := ccie(thetaZ): 
normal.x3d := slnY'co.'^X: 
riormal.y3d -sinX; 
normal. z3d cosY^eosX; 
rotX.xlD := 1: 
rotX.ylD := 0; 
rotX.a3D := 0: 

RotateZfrotX, sinZ. cosZ. rotX): 

RQtateXCrotX. sinX, cosX* rotX); 

RntateY{rotX. fiinY. cosY. rotX): 
rotY*K3lJ E: 

rotY.yll) 1: 

rotY-zlE 0: 

RotateZ(rotY. sinZ. cosZ. rotY): 

RotateX(rotY* sinX. casX* rotY): 

RotateY(rot¥, sinY. cosY. rotY); 

Tor J J to numPotntn do begin 
pL.xin thcPointlj ll.xZD; 

pt.ylD thePoint [ j 1]*y2D: 

pt.23D := 0: 

RotateZlpt. sinZ* cosZ, pt): 

RotateXCpt. sinX. cosX. pt): 

RotateY(pt. slnY. cosY. pt): 

ptn(j] pt: 

ir j = 1 then begin 

iiiln_x pt: miri^y pLi i]iin_:ii pt; 

tnax_x := pt: iiiax_y pt; ttiax„z := pt; 

end else begin 

if pt,x3D < min_x*3t3D then begin 
min 3t t- pt; 
end: 

If pt.ylD < min_y.y3D then begin 
mlri^y pt: 
end: 
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fith so many products available to boost 
performance and creativity, your Mac has never 
had more potential than it does today. See the 
best and latest of these enhancements at 
MACWORLD Expo/Boston! 

The product offerings at retail stores are no match 
for the breadth of choice you'll find at MACWORLD 
Expo. Catalogs may offer variety, but no opportunity 
to see demonstrations or ask questions. Only 
MACWORLD Expo lets you experience the full scope 
of Mac computing, with thousands of solutions for: 

• Web site design and Internet navigation 

• publishing, entertainment and multimedia 

• networking, enterprise-wide connectivity, 
and intranets 

• education. K&D. research 

• business and telecommuting 

The Mac universe is 60 million users strong. Rub 
shoulders with thousands of the most innovative, 
ingenious, and committed users at MACWORLD 
Expo, Network at special interest areas and pavilions 
that are free to all attendees. Learn from the experts.. 
keep abreast of trends... maximize your Mac- 

investment in more than 80 conference sessions. 
MACWORLD Expo opens your mind to new 
horizons accessible only through your Mac 


IlUaUIRE TODAY 
FOR MORE 
INFORMATION 
ON MACWORLD 
EXPO. - 


See us on the mrWW at: 
httpV/www.mha.csont/ 
niacworlclex|»o/ 
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Please send more Information on MACWORLD Expo 
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Name __ 

Tirie__ 


Company _ 
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Mail to: MHA Event Management, 1400 Providence I lighway. 
RO, Box 9127, Norwood. MA 0?0fr2 Or Fax tO: 617^44(1-03^7 
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if pt.z3D < min_s.z3D then begin 
inin^z pt: 

end: 

if pt.xSD > max.x.xiD then begin 
max_x := pt; 
end: 

if pc.y3U > inax_y.y3D then begin 
iikax_y ;= pt: 
end: 

if pt.z3D > niax_z.z3D then begin 
niflx_z pt: 

end: 
end: 

end: 

dist_x Distaivce2( inin_x* inax_x ); 

diet_y := Diatance2t min_y* Tnax_y ): 

diat^z Distanca2C inin_z, max_z ): 

if dist_x > dist_y then begin 

If difit_x > di£?t_z then begin 
radiua2 dist_x/4: 

KidPolnt ( tBlri_x, Eax_x. center ): 
end else begin 

radiua2 := di-st_z/4: 

Midpoint^ min_z, max_z. center ); 
end; 

end else begin 

if dint_y > dlBt_J5 then begin 
radius2 dist_y/4: 

MidPointC miri_y, 3iiax_y, center J: 
end else begin 

radius2 diat_z/4: 

Midpoint( niiii_z. niax_z. center ): 
end; 
end: 

for j := 1 to nnmPoints do begin 

new_radinE2 := Distance2( center, ptsLjJ ); 
if nev?_caditifi2 > radius2 then begin 
radius sqrt(radiua2) : 
nev_radiUE := sqrt(new_rad 1 Lis:2} : 
radius2 (radius + new_radlus3/2; 

old_lo_new radiusZ radius; 

CGntcr,x3D := (radius2*center.x3D + 

old_to_new*ptsijJ.x3D)/radius: 
center.y3D := (radiua2*center.y3D i 

old_to_new*pts{J].ySD)/radius: 
center,z3D := (radius2*center.z3n + 

old_to_new*pts(J],z3D)/radius: 
radius2 sqrCradius2) : 

end; 
end; 

AddVectors{ polyPlane,planeOrigin, center, center ): 

end; 
end; 
end: 


CiiikPiujcction 

procedure CalcPcojection( 

offscreen; GWor Id Pt r: (* GWorld lo draw projcdion ’) 

const thePolys: MyPalygon Ar ray; (* polygons m project *) 
n umPo 1 ys: 1 ongi n L : (* number of polygoii^ to project *) 

const viewpoint: Hy3D?olnt: 

C viewpoint from wliitii to project *) 
const illumPoint: Hy3DPoint: 

(• illumination ptiint fnjm w'hich to draw shadow ’) 
storage: uulv Ptr: (* atixiliaiyf ^to^age prual)ix:ated for your use *) 

s to r a ge S iz e: lo ng 1 nt (* nu mber of byttii of storage *) 

var 

bounds: Rect: 

X, y : integer: 
colour i RGBColor: 
viewKay : RaySD; 
lightRay : Ray3D: 

\ : integer: 

closcstOistonce ; float: 
closestIntersectionPt: My3DPoint; 
thisDistance : float: 
inters ectionPt: My3DPoint: 
inters ect_pQlygoTi: longint: 


pm: PlxMapHandle: 
j unlt^bo 0 1 ean: booleai:; 
pixels: Ptr: 
rowbytes_add: longint: 
iiiy_storaget StorageRecordPtr: 
begin 

ISnnusedC storage, storageSize )| 

my storage := StorageRecordPtr(storage): 

PreparsePolygona( ]iiy_storage, numPolys. thePolys J; 

SetGWorld( offscreen* nil ); 

bounds := offscreen^*PortRect: 

pm := GetGWorldPixMap( offScreen ); 

junk_boolean := LockPixels( pm ): 

pixels GetPixBaseAddr{ pm 3 ; 

rovbytes_add := band( pm^^.rowBytea* $3FFF ) 

4 * (bounds.rlghl bounds.left): 

for y := bounds,top to bounds*bottoni-l do begin 
for X bounds,left to bounds.right-I do begin 
MakeViewEay(viewpoint * x* y* 0. vievRay}: 
ciosestDlstaTice ;= 0,0; 
inter sect _polygon := 1: 

for 1:= I to numPolys do begin 

if Intersect(vlewRay, thePolys[il], 

iiiy_storage'^,poly_extra[1 ■ l] . thisDistance, 
intersactionPtJ then begin 
if (thisDistance > closestDistance3 then begin 
intersect_polygon := 1: 
closestDistance := thisDistance: 
clonestIntersectlonPt := IntersectionPt; 
end: 
end 
end; 

if intersect_polygon > 0 then begin 

colour thePolys[intersect_polygon'1].polyColor ; 

MakeViewRaydlluniPoint, closeatlntersectionPt ,x3D. 
closestIntersectionPt.y3D* 
closestIntersectionPt.z3D* lightRay); 

for i:“ 1 to nuiiPolys do begin 
if (iiiterafict_polygou <> i) & 

Intersect(lightRay* thePolys[l-l]* 
iry_Rtorage^ , po]y_extra [ t -1 ] * 
thisDistance, inietsecLlonPO then begin 
colour.ted := band(colour,red * $DFFFF) div 2; 
colour.green := band(colour.green. $0FFFF) div 2: 
colour.blue band(colour.blue* $0FFFF) div 2; 
leave; 
end 
end; 

LougintPtr (pixels):= bsl( band (colour, red * SOFFOO) * fi ) 
t band(colour.green* $0FF00) t 

bsrC band(colour.blue, SOFFOO), 8 ): 
end else begin 

LongintPtr (pixels)'' := 0: 
end; 

lougint(pixels) longint(pixeJs) + 4: 
end: 

longint(pixels) := longint(pixels) t rovbyies_add; 
end: 
end; 

end* 


Visit MacTech® Magazine’s Web site! 

http;//www. mactech.com 
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If you want to be in the know, then you 
need evety article published in the first 
12 years of MadTech® Magazine and 
Apple’s develop™ issues 1-29! 


.,. in THINK Reference' format! 


So hurry, pick up the phone, fire up 
the e-mail, launch that fax machine, 
or simply drop by our web site and 
order yourself this new release of 
the MacTech* CD-ROM. 

• Almost 1600 articles from all 139 issues of 
MacTech Magazine (1984-1996) 

■ Includes Apple develop issues 1-29 

• Improved hypertext, improved indices, and a new THINK 
Reference Viewer — for lightning quick access! 



• New hyperlinks between articles 

• 100+ MB of source code — use them in your applications, with no royalties! 

• Full version of THINK Reference — the original online guide to Inside 
Macintosh, Vols. I-VI 

• 80MB of FrameWorks/SFA archives and tlie most complete set of Frameworks 
archives known 


• Sprocket*'"! MacTech's tiny framework that compiles quickly and supports 
System 7-5 features 

• The best threads from the Mac programmer newsgroups plus thousands 
of notes, tips, snippets, and gotchas 


• Popular tools that Mac programmers use to increase their productivity and 
much more! 



Web Site: http//www.devdepot.com • E-mail: orders@devdepot.com 

Phone; 800-MACDEV-l • Outside the U.S. & Canada; 805494-9797 • Fax; 805494-9798 


MacTech is a registered Irademark of Xplairt Corporation. MacDev-1, THINK Reference. Developer Depot, Sprocket, JavaTech. WebTech, BeTech, and the MacTutorMan 
are trademarks of Xplain Corporation. Other trademarks and copyrights appearing in this printing or software remain the property of their respective holders. 






by Nicholas C. ''nick.c''DeMello, <lIlUs@maclGch.com> 


Let the QuickTimes Roll 


QuKitTiME — Moving PicrrLUi’S 

“QuickTime, a set of functions and data .structures that you 
can use in your application to control time-based data.” 

— from the Netv bisiclc Macintmh: QuickTime 

Moving j>ictures impress. Your application can have a startling 
splash screen or a dynamic al:x>iir lx>x, and the QuickTime pages 
at Apple have almost 50 code examples to .slu>w you how. Of 
course, tlie essential reference for QuickTime is the New Inside 
Macintosh: (XiickTime (ISBN 0-201-62201-7), written by Apple and 
published by Addison-Wesley’s Developers Press. An eleclronic 
version of that bexjk Ls available from Apples developers world 
pages in either Acrobat or Apple D(x:View^er fonnat. Make sure to 
review the Quick] uTie tips at Terran Interactive and Charles 
Wiitgen’s QuickTime FAQ before digging L<k> deep into NIM. 

Graphic Converter hasn't appeared at the info-imc archive 
since version 2.5, but the latest version (2*8) of this essential 
shareware utility can be downloaded directly from r!ie Ijenike 
Software^ [>ages. Among iPs many leaiures, Graphic Converter allows 
yoLi to combitie a series of static iimges into a single QuickTime 
movie. Lcx^alized versions in bnglLsh. French, Swedish, Spanish, and 
German am be downloackxl. Another valuable freeware is 
Movie Clei[ner Lite, availal)le from tile Terran Interactive site. It 
supjxirts c'onversion between Cinepak and Indeo ctxlees, for those 
of you moving QuickTime videexs Ix^tween MacOS and Windows. 

Apple's QuickTime Pages 
<http: //qu I dctime. applexom/> 

QuickTime Sample Code 
<http:/^www.quicktime.appie.com/d ev/de vs w.htm I > 

Inside MadntosJi; QuickTime 

< h rtp //de vwo rid, a pp I e com/d p V/techsup por l/in siden ac/Qu i ck ri me/Q u fck Tirne-2. h Im b 
QuickTime Tips 

<h t tp://rerrar3-iri I. coni/QT I m f o/QT I n fo.h I ml> 

The QuickTime FAQ 

< h t rp://www.QuickT( me FAQ.org/> 

Graphic Converter 2,7 

< http://ww w. je m ke soft .pi ngn et.de/> 

Movie Cteaner Pro 

<http://www.tefran- in t.com/prod/Cleaner. htm l> 

QuickTime VR & QuickDraw 3D — 

Moving Into the PiciTfRE 

Just as rapas predatal disks, linear access movies and stxind 
tracks were only the first step in QuickTime. The QuickTime Media 
Layer now includes the new technologies QuickTime VK and 
QuickDniw 3D which allow users to interact with QuickTime movies 


— to explore QuickTime worlds. C^ickTime VR lets a user to rotate 
their perspeaive and experience a 360' view of a scene. It tun alst> 
allow a iLser lo roll an object in sjxice — to see that same olTjcxl from 
any side tliey choose. Apple lias put a quick explarmiion of how^ 
QuickTime VR accomplishes both these tasks online, with iiKjre 
derailed information awtila[>le at their QuickTime VK FAQ web page, 

QuickTiine VR can add an impressive degree of interactivity 
to your web pages and to your Direaor movies, Jbe latest version 
of the QuickTime VR Plug-in for ix)lh environmenLs is available 
from Apple. Bui Apple isn't .stop}>ing there. Current Apple plans 
include inerging the QuickTime VR worlds with QuiclcDraw 3D 
technology. QuickDraw 3D allows you to define objeas in space, 
then manipulate them wuthin your code and dynamically render 
the scene into 2D fomi. Visit tlie QuickDraw 3D web pages to see 
dramatic examples of this 3D standard, and to download rhe latest 
version C1.5T) of the QD3D extension. Nine develop articles have 
de.sc:rilx?d liow to implcnieni QuickDraw 3D, and A]>plc has put 
tliem and tlielr example code online at Developer World. 

With Quickl ime, worlds of sound and animation, panoramit: 
vistas, and dynamic 3D objecis can exist on your web sites and 
within prog ran Ls* Let the QuickTimes roll... 

How QTVR Works 

<h ttp://quickti mevr. d ppk. tom/ho w.hlmb 
The QTVR FAQ 

<http://quickti mevr. apple. com/dev/we b faq .html> 

QuickTime Plug-in 1,1 for Netscape 

< h llp://quic kt j me vr. apple, com/sw/qtvrmac*h t m I > 

QuickTime VR Plug-in for Director 

<http://quickti mevr apple. com/bin/Forms/xtra_down load. eg i> 

QuickDraw ID 

< http://q L ickdra d.applG.£:Qm/> 
develop QuickDrawBD Code Examples 

< http ://devwor Id.apple.com/dev/tedisL!ppon/c!evelop/bysiibject/quickdraw3d.html> 

PARTfNt; Shots 

Next monih MacTecli Online Is going to get serious about 
Java. Until then, those of ycxi who missed the 1996 WWDC mtghr 
lx? interested in reviewing the slide.s IVom the imaging w'ork,shoj>, 
indudlng Shawn Mopwcxsdls overxaew r>f QuickDraw 3D (be .sure 
to also dow'nioad the player lor the slides if you don't have 
Persuasion installed). See you next month* 

— nick a- <mailto:online@mactedi.com> 

1996 WWDC Overview of QuickDraw 30 

<dtp ://f tpd p V. i nt o.a p p I c. com / Do VC I opGr _SGrvice 5 /ProgramsA/VWDC_P resentation s/WW 
DC_1996/300Jrack_-_IMG_sessioffS/30UQuickDraw_30,Overv1.stt.hqx> 
Persuasion Player for Slides 

<f tp://ftpda/. i nf aa pple. com/ De ve loper_Seivl t:e5/Programs/WWDC_F resentations/Pers 
Ljasion_Player_3.0.sit.hqx> B 
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Software Engineering 
Made Easy! 


File Edit Report LUindoio Page Formal Oplino 


3:02:52 PM 3} @ 


OicliDoargt Simj; 


MBmaHHamwi bbBSS 


Bromsc: SitnpflppJr 


Opert 

Oocunent B*Cid 
□ocuHnl Ur \U 
EwtHondl^ 

E<>en IKortd I er. ^tuF>l1»nuE 

Fi leHme 

FUeNcwMiType 

Ffc IfifiQ f 

L^^tfirroy 

LjTtOf£hflp<»r 

L l«tDrShop«s . Each I 


P 1 Neill 1 ISobtlo^^^l i Fdil | [ Delete [ [load] ) Inheritance 


TFtppJ icjot^on 
TBox 
TCircle 
TDocwMtii^ 

TLtSt 
TnHr^yrT 


Open 

R€Kid 

Close 


flJimkM 

tTjtIfl 

t ShopeL I = L 
tp;leBef 



/* to disk and raise ting sbopei */ 

/* iTOocumentSi */ 

doss TDocyiftent : pudic TEoentHondlef' 

( 

piA Me 

THlndow^ fWirxJow; /* pointer to do»jniant‘s wlnda 
FlIoMcK^Iypa* fTitls, 

TLisl> fShc^wList* /* list of shapes in doewsent 
Ini iFliri^fcf, flltt iftcrBiger neferenoe to o fi 


npject: Jntr.DBj: Read n Document 


j fipp H oo 11 on^ ^ ^ctinen I j ^ t stO faiapes^ j ^Shop*^ 2 

i Initlol izo I 

: - ^ 


Clo 


Reod f 


Irisart 





The sporty new interfane in MacA&D 6.0 enables ttesi^ners to rMck to preperties, dictionary 
details, integrated specifimthns, cade or related requirements for any selected diagram object. 


See hlLp://wwwxxcelsoftwarexoni for more details. 


MacA&D and WinA&D simplify 
system analysis, track requirements 
specifications, automate ix)pular 
modcUng lechniques and generate code 
from yoiir design. Throughoul Ihe 
process, extensive verillcation reports 
catch errors early to help you produce a 
qualily producL 

Powerful capaUilities are just one 
advantage. Years of innovation have 
made tliese products easy to use and 
each includes extensi ve examples and 
tutorials. MacA&D and WinA&D share 
documents so your project team can use 
Macintosh, Solaris, HP-UX or Windows 
95/NT computers. Select tVom OMT, 
Booch, Shlacr/Mcllor, Coad/Yourdon, 
Pusion or Jacobson methods or pick and 
mix the best of each. 

0 Structured Analysis & Design 
^ OlijecL-Oriented Analysis & Design 
9 Data, State and Task Modeling 
9 Integrated Cfxle Hditing & Browsing 
9 Multi-User Dictionary 
9 R eq uire men Ls/l J se C ase s 
9 Generates C, C++, Delphi, SQletc. 


Powerful Tools 
For Software Design 





ir,-' 


Eirtl Software 


Ev 


MacA&D 


Iv VAritltMOl 


I' - -mm 



U 

h _ V * " _ 


f;A' 


K' ■ 

u- 

C* Estul Sotlwartr 

WinA&D 




MaeA&D 

for Macintosh, Solaris and HP-UX 


WinA&D 

for Windows 95/NT 


Sec our web site or drop us an email 
to receive detailetl technical brochures 
for MacA&D or WinA&D. Check out tlie 
new MacTranslator and WinTranslator 
products u> generate design documents 
automatically from existing source code. 


Excel Software 

515 - 752-5359 


© 1997 Excel Software, MacA&D, MacAaaiysl. 
MacTraMlalOf, WinA&D and WinTranslalot are 
trikdemarlui of Excel Software. Pli. 515-752-5359, 
hix 515-752-2435, Rmai! infQ®excelsoftwarc,com, 
Web: http: //www.cxecisoftware.com 



























































































by Andrew Stone, Chief Executive Haquer, Stone Design Corp. 


Porting to Rhapsody PPC from OPENSTEP 


Want your OPENSTEP 
application to run on more 
than one platform? Apple 
is making it easy 


In late 1995, when tlie future for NeXT 
Software, Inc. seemed rather bleak, the 
hrsi l)cla version of OPRNSTHP 4.0 shipped 
to a few faithful developers. Faced widi 
doing Java development in incomplete 
environments, 1 decided to yet again 
recommit to OPENSTEP and port oiir best 
selling drawing and design program, 
Create, which contains the Slone Lthmries 
upon w^hic'h our other apps are based. In 
an effort to save others from liie pitfalls I 
fell into, 1 produced a porting guide 
<http://\AAAW.stonexom/porting/> doaimenti ng 
the likely gotclias of the process of porting 
from NEXI’S'l’HP to OFHNS'rEP. 

It tc.x>k me one month to port diis 
100,OtX) line code base to a state of linking 
and limping. After 8 months of intense 
debugging and working back and forth 
lx;twecn the NT and iVlACH icanis at NeXT 
and the SOLAldS OPENSTEP team at SUN 
MkTo.systems, Create 4.0 rolled into beta, 
and was the first app to s!iip for OPENSTEP 
in the fail of 1996. Proving tlie claim of true 
cross platform compatiliility, it mn on 
Windows 95 and Window NT, SOURIS, and 
OPENS^fEP MACH for Motorola, Intel and 
SPARC architecaires. Since the development 
and [lorting tools were just Ixiiog debugged 
for the first time and my OPENSTEP 
knowledge was still nascent, the proems 


was lengthier tlian a p<7Tt from NEXTSTEP to OPENSTEP would be 
today. We shipped, and were underwhelmed by the lack of 
response from a beleaguered set of OPENSTEP users. 

Apple aajuiring NeXT on Deccrnlxrr 2QLh, 1996 changed all 
of tl^at, proving once again that reality is far stranger than fiction. 
The Wheel turned full circle and die renegade ex-Mac developers 
were back lK3me! 

TLs true dial perseverance furdiers, ix^cause 2 weeks prior 
to die 1997 WWDC on Cinco de Mayo, I was invited to NeXT 
Software’s heatlqiiarters in Kedwocxl City to build Create for the 
PowerPC. Unlike any previous visit to NeXT where 1 was 
watched with hawk-eye and not allowed to go anywhere 
unescorted, 1 was given full reign of the second floor of 
engineering, replete with my own office and access to that 
legendary' es]>resso maker. 

'j'wo binaries were needed for the show: one for Rliapsody 
ninning on Intel, the other for Idiapsody ainning on PowerPC, The 
app was aiso liuili to showcase Yellow Box running on Windows 
with liie Windows look and feel. Iliis build compiled witliout 
warning, the app launched and hung. It aims out dial 1 had a 
vestigial line of code fmm NEXTSTEP LD circa 1989: 

[menu dlnplny]: 

Tliis was a workaround to gel die menu to redraw after 
dynamically adding menu items. However, in die brave new 
world of lihapsody, one cannot be sure what a menu is. NormaEy 
a menu is a subclass of NSView, which contains a display method. 
Under Rliapsody, A()ple's drop-down inenLi is not a subclass of 
NSView, and does not recognize the display mediod, 

The engineers at AppIe/NeXT, in ihe mklsi of going through 
a total reorganization, had ported die kernel and compiler tools 
to PPC witldn a matter of months. They had built a cross* 
compiler to build PPC binarie.s from Intel machines, and once 
again, Create compiled cleanly, Tlie PPC kernel was only a few 
days old, still dripping with aniniotic fluid, when the first 
ccmimemial app jiLsi came up and ran. As key team member Matt 
WaLsim is oft heard saying, 'dt just works!Shouts of joy from tlie 
team could be heard throughout the building. 


Andrew Stone, an early HyperTalk developer and a>anthor of ‘‘Tricks of the HyperTalk Masters'" emigrated to the NeXT 
community in 1989, going on to write such NeXT classics as TcxlArl, Create, Datal^hilc and 3Drcality. 


70 


POiaiNG I'O JillAl'SODY PPC FROM OPENSTEP 


MAaT.x;ii • July 1997 















(al ® 0 0 0 


WWW.STONE.COM 


mmm. 


True to the promise of Rhapsody, no coding changes were 
required for the PPC/Yellow Rox port, a few NeXT Interface 
Builder flies (niiDs) had to be adjusted to be more Macdike — 
inainly Creates main menu had to have its menu items 
reordered and renamed slightly to feel like a Mac. To solve Uiis 
problem, a new interface loading paradigin was introduced: if a 
nib file has a platform suffix, that nib file is loaded instead of 
the one without a suffix: 


create 

File 


;i#:Emptyfnl 

File r- 




u . .. .... f. f. n , t > I,. dMHi*- 


- P«*r 

Pages ESS; 




BacfcgroiJ;rid.:|F|| 

Tools 


^Windows 

Eiervioes-'^; 







NEX'iyiEF look as provided by 
NEXTSTEP <Nm FILE NAME> nex£slep, nth 



Macintosh look as provided by 
Macintosh: <NfB FUJi NAME>-mu€inimhMih 


99mmwm 




ii 






Edit HTML M Ffifmait look Wiidp^ S^View 

Open... Ciih-D 

Iruaort.. Chf+Shift+O 

New Dit+W 

CtiJ+Sfiift+N 

Pd^s ► 

Background * 

Pose ,, Ctri+W 


i* PiSje Setup,.. • 
£nnt 


QdtShift+P 

Ct<l^ 


Prefefences... QiW 


EKit 


Dd+q 




Windou^s look as prouided by ^Windows 
m95_<NIBJ^lLE_NAMF>-tmdowsMW 

The Mac and Windows NT/95 menus use a separation 
marker that you can find on the Menu palette of IB when you set 
tlie “hiterface Style'' in tntertace Builder’s Preferences (General) 
to ''OPKNSTHP for Windows."" The separation marker must be 
disabled in the ID inspector to give it die light gray look. Menu 
organization and menu item naming should folkiw Uie User 
Interface guidelines of the tai^et plaifornc 

Having taken tlie time to learn Java and the various 
development environments from Sun and Symantec over the last 
couple of years, I can unreservedly say that Rhapsody rcxks the 
house and Java has a lot to iinplement before it offers the power, 
elegance and integration of Rhapsody. After this delightful 
porting experience, 1 believe tliat Rhapsody is Write Once — 
Runs Right Everywhere. El 
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hy Jessica Courtney 



Kaidan Announces KiWi 
A IjOw Cost Panoramic VR Tripod Head 

KiWi is tJic first truly affordabie panoramic VK tripod liead. 
KiWi hiings digital photographic panoramas to an even wider 
audience. With the advent of eiLsy-to-use and arf<>rdal>le VR 
panorama cremation software, such as PictureWorks' Spin and 
Paniination's Nodester, the KiWi panhead provides a complete 
solution that is ideal for anytme interested In adding digital VR 
panoramas to their websites, e-mail and multimedia applications. 

'rile KiWi bracket coasisls of two intersecting aluminum 
struts that adjust and lock to accommodate the notlnl points of a 
wide nmge of tligital and amvenlional cameras, such as the 
Kodak DC50, Apple QuickTake 100/130/200, APS film cameras, 
up to 33inm SLR cameias equipiied with ISmm lenses. When the 
two locking screw's are loosened, the KiWi pan head 
disiissembles into two flai f)icce.s tliat easily fit inside a cameni 
bag. Dimensionally, the atljustment range of the KiWi supptiits 
cameras with a tripod mounting thread-fo-nc^ial poini distance of 
4 3/H inches () llmm) imri a camera mounting .surracc-to-nudal 
l>oini distance of 5 1/4 inches (133mm), 

KiWi an:achc,s to any stantlard tripexi and camera equipped 
With a standard 1/4-20 mounting thread. Ifnlike the other 
models of the Kaidan QuickPan line, which use angular detents 
to provide click-stops, tfie KiWi u.se.s a specially designed 
friction joint that provides smooth and even drag while turning 
the ('amera. A eonvenieni label on ihe tiase provides a Liear 
indication of die loeacion and increment angle of the camera. 
<info@kaidanxom> 

QlickCRC 1,0 — Software Design Tooi. 

Excel Sofuvare, makers of tbe |)opular MacAitl) and 
WinAM) software engineering tools, today announced 
availaliility of QuickCHC 1,0 for both Macintosh and Windows 
95/r4T. Quic’kCRC is a software design totjl fur diseovering 
tjbjecls and related infonruition for an object-oriented software 
development project. (,)uickCRC autoinates the CKC atrtl concept 
of ic le n t ify i ng classes, rt*spo ns i hi I it les and ct ) l la I )o ratit ms 1 x-t ween 
objecLs. It provides dcveIo[X'rs with a jx>werfu], intuitive design 
ttK>l that requires little or no tbrmal training, 

QuickCKC uses a diagnim wcirkspace for crcaiing card and 
.strnario olrjccLs. A card re[iresents the projxmies of a class 
including its name, description, superclasses, subclasses, 
attributes, responsibilities and collaborating objects. A .scenario 
repre,senLs a design mechanism defined as a scries of steps 
involving communicating objects. Scenarios can reference cards 
or other scemirios. Information is entered Into the Property 
dialog of each card and .scenario o!)ject. Cards and scenario can 


also reference external agents defined by the designer to identify 
system and user interfaces for the softw'are Iteing designed, 

Quic:kCRC provides active simulation of an evolving design. 
Features include single stepping backwards, forwards or over a 
called scenario or jumping to a specific lot:ation in the scenario 
stack of a muitiple scenario simiilation. Designers can even 
simulate meitianisms in an inctjinplete design by just selecting a 
scenario and clicking the Simulate hutton. 

QuickCRC automatically and transparently maintains 
relationships between cards^ scenarios and external agents as 
fluid design changes take place during the early phase of a 
development project, For example, if a c'ard references undefined 
suix'lasses or superclasses, those cards are generated 
auiomatically. Name changes and cross references between 
objects gel updated iasianify. Card and scenario objects c:an lx 
arranged visually on the diagram by QiiickCRC based on user 
spc'c’ified criteria to highlight relationships between objeas. Card 
and scenario objects can be sepamted into different diagrams 
based on functional areas of a complex design or can and pasted 
Ixtween different projet i documenis. Design nu>dels can lx 
verified to kx:ale errtirs. Itilbrmaiion can be listed to a text report 
to serve as a coding sjx^cirtcation. Design mcKlels c'an also lx: 
exponed or imponed to Excel Stiftware's MacA^D and W'lnA^D 
software engineering ukjLs for detailed design or code 
generation. Likewise, Excel Software's MacTranslator and 
Win'franslator can Ix.^ used to automatit'ally generate QuickCRC 
design nuxlels from existing Ot, Object Pa,seal or Delphi code. 
<http://www.excelsoftware.com> 

Java News Oi i ers Dmly Disthjate of Java 

H<xister Technoiogies uxlay ofilcially launched “Roasted Java 
News,'’ an online Java News Daily. Each frcslily updated version 
includes a comprehensive collection of news headlines 
concerning Java culled from over 50 different publications 
available on the Internet. In adtlition, a defxulincnt of "Short 
Takes" supplies information on new or updated applets, 
applications or Java-related sources. 

Roaster 'Ibchnologiex* w'elisite also fu ml ions as a major Java 
resource for technology jx.‘t>ple working with Java, 'Hie newly 
revised site, alst> making its debut, inclucies a popular .section 
called "Roasted Java links," which pnivides an easily accessible 
wealth of information on Java related resources. 'Hiis area gives 
liie u.scT current, verified information aboiii otlier sites of interest 
to Java users; the user no longer has ro wonder if the link is 
outdated, or stale. The webmasters at Rcraster have done the work, 
<http://www.roaster.com/news/> E 
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SpoQSortd by Apple Computer, Inc, and MacTech Magazine 


Apple, fhe A|iple It MaUutosli, Mac. aid llx Mac OS logu an? a^givtcnxl ir£dcm,irks of Apple Computer, Inr. Developer Central, Victual Dcvdojxr Cental 
atv iratkmarlw tjf Appk Computer, Inc. MacTtxh is a agistcxxl iradcmnrk anti Devt^ktper Dqxit ts a tradefnark <if Corixstaiioii. 














TIPS & 
TIDBITS 


by Stei^e Sisak 



In article < 19970223210019110631 @stcc010,ulavaLca>, 
<cbmnet@geocities.COm> (Charles Brunet) wrote: 

When I call FSpDelete in my application, the document is 
not always deleted from the Finder. Sometime, I must create an 
ocher document with the same name to erase it. Is it possible to 
ask Finder to forgst this file right now? 

1 have the same problem when 1 create a document. It take 
some lime before it appear in die Finder. 

How CO update the informations in the Finder? If you have a 
scriptahle finder, you can send tt an update event. Here is a snippet 
from an fas of yet) unreleased piece of M)ftware: 

OSErr 

TCTypcTI: SendFlnderAEUpdate (rSSpec fiiinFile) 

J 

OSErr err = noErr: 

AEDeBc proceBsDesc; 

AppleEvent ae* aeSeply; 
ae.descriptorType = aeReply.descripLorType ■- 
p roces sDesc,d esc rIpt o rType 
= typcJjull: 

ae-dyttiEandle * ^eHeply.dataHandle = 
proces3Desc.dareHandle * nil: 

Try_ t 

DescType flnderType “ ’MACS'r 
err “ 

i; AEC rca t etJesc (typcjApplSignature, tif inderType. sizeof (DeacType), 
AprocessDesc )t 

FailOSErr_terr): 

err “ ::AECre eteApp1eEvent(* fnd r', 

' fnpd’. &prr^cesBDesc , 

kAuroGeneratcReturnippkAnyTransactionlD,iae) i 
FallOSErr_(err): 

err “ 

::AEFutFatauPt r(,keyDitectObj ect.typeFSS.tinFlle.siseof(inF 

tun I 

FailOSErr (errh 

err * :: AESend (&ae,&acRoply, kAENoReply | 
kASNeverlnteracU 
kABNorinalPriority. 

kAECefauliTinieout .nil.nil); 

FailOSErr_(err): 

1 

Catcb_{catchErr) lerr = catchErr:] EndCatch_ 

if (proceRsPesc-deseripiorType !'' typeKull) 

1 ARDisposeDcsc(&p roccssDesc): 

if {ae-descriptorType 1= typeNull) ::AEDispoBeDeac(&ae): 
if (atjRepiy.deecriptorType != typeNull) 

:AEDisposePesc{taeReply ); 
return err: 

Jim Correia 
pmtb02Jc@umassd.edu 

Screen Shots the Gnariy Way 
One thing you can't do on die standard MacOS today is take 
a screen snapshot with a menu being displayed (or indeed, with 


the mouse down). There are lots of third-party solutions to this, 
but in fact there is a way to get such a screen snapshot, by 
installing no additional software other than MacsBug. And since 
all readers of this magazine already have MacsBug installed 
(well, don't you?), that means you can indeed take screen 
snapshotvS with menus displayed on your Mac! 

CAUnON: diis technique can crasli your machine, or have 
other unexpeaed consequences. Perhaps you should look on it as 
Another Fun Thing to Do With Mat^iBug, to show off to your fellow 
geeks at parties, rather than as a serious technique for regular use. 

First of all, type cmd-shift-3 to invoke the standard screen 
.snapshot FKKV. This is purely to make sure the FKEY code is 
loaded in memory; you can llirow away the PICT file it creates 
at this point. Next, hold down tlie mouse button to display the 
menu that you want to take a snapshot of. While still holding the 
iiutton down, use your other hand to press the intermpt button 
(or key sequence) to break into MacsBug. Once tlie MacsBug 
screen appears, you can release the mouse button. 

Use the “hx" command, if necessaryT switch to the system 
heap. Now use the command 

hd FKEY 

to find out where the code for FKEY 3 loaded. You will 
sec a display that looks something like this: 

Displaying tbe System hnap at 000€?OOD 

Start lipngth Tag Mslr Ptr Lock Prg Type ID 

File Naae 

003BF52C 00fJ0046C+08 R OOlSDAlC F FKEY 0003 

0002 

#1 block listed, which uses #1152 bytes, storing #1132 
bytes 

(If you see more than one FKFY loaded, tlie one you want 
will have “0003’* under the ID column.) Make a note of the 
hexadecimal nunilier under “Stan" — that is the .slan addres.s of 
the FKEY code. Next, enter the following commands: 

sp := sp -4 

si sp pc 

pc XXXX3£X3SX 

(replace llie ^xxxxxxxx” witlj the start address t>f FKKY 3 you 
obtained before.) 

Finally, enter the command “g" to resume execution. You 
.should hear the dick of the snapshoi Ixing taken, followed by 
the disappearance of tlie menu that was lx!ing displayed. But if 
you have a look at the resulting snapshoi PICT file, you will see 
that it shows the menu! 

Assuming your machine stays up iliat long (hee-hce)... 

laufrence DVlimro 
<WO@umkatoMc.nz> 
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the best qualified Macintosh prog- 
rammers and developers, let MacTech* 
Magazine deliver your rccruit-nacat 
message lo an audience of over 27,000 
quafi/ied computer professionals. 

Call Rufh Suhrin at 805/4^4-9797 
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Nystenui. tntcimeT i^ik] GUi apps, 

Wc are ;in evenly mixotl Mac/MS 
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h|^};//www.taf^(:^g^3ptlKls.erll11 
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Professional software developers 

iooking for career opportunities 
shoidd check out our web site. We 
offer nationwide employment assis¬ 
tance, resume help, marketability 
assessment, and never a fee to the 
applicant. 800-231-5920, Fax 800- 
757-9003 eMaikdas® scientific.com 
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Placement, fiic. 
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Object Support Library Version History 


This anide is an alietnpt io darify fhe 
uemrm history of Apple's Ohjecl Supjxnl 
Lihmryf (OSL). This Uhrar}* pwmdes 
routines that appHcations can use to 
supfxrrt the Open Scripting ArchitecUire 
(OSA) ohjecl model. 

OSL WHS originiilly released as a 68K 
siatie library. Witli the iniroducLion of 
Power Macintasli systems, OSL was 
repackaged as a shiired library. When the 
Ctxle Fragment Manager 68K Runtime 
Enabler (CFM-68K) was released, it 
became a hn Ubrar^^ containing lx)th Powder 
PC and CFM-68K versions of OSL. 

Tills ankle lisis all versions of OSL 
that are currently available along with a 
brief histoiy and description of each one, 
and recommendaiions as to whidi versions 
to use (and not use). 

If you develop Macintosh applications 
that provide OSA object model support, or 
need to use applications that do, you 
should read this aiiicie. 

In the Beginning of OSL 

When the OSL wiis first released, it 
was a 68K static library 
(AFOhjectSupportLtb.o) that was .statically 
linked into applications that .supported tlie 
OSA object model. This is still the case for 
classic 6SK applications. 

Wiih ihe release of the Power 
Macintosh and the accompanying CFM 
shared lihinry application model, it was 
decirle that a shared library version of the 
OSL (ObjcctSupportLi!)), rather titan a '.o' 
file, should l>e provided for PcwerPC- 
narive applications. 'ITiis would allow 
native applications to take advantage of 
the shared library apijlication mcKlel. 

'Ihe OSL PowerPC sliared library^ was 
released as version 1.0.2. It was included 
with the first Power Macintosh system 


softw'arc (version 7.1.2) and the AppleScript SDK version 1.1. It 
Is currently still available on the Mac OS SDK CDs. This version 
of the OSL has a nuniix:r of known bugs in iLs handling of whose 
ciaLises. (Tlie.se bugs are listed in the Known Ikigs in tlie OSL 
section of this Article.) 

Tills first .shared library introduced the first OSL shared library 
problem. Tlie OSL was written in Pascal, but tliere were no 
PowerPC Pascal compilers, so it contained a small PowerPC- 
native lii jrary that loaded a 68K code resource con lain ing the OSL. 

But this loading was not done properly; tlie 
ObjectSupportLihLs resource file often ended up in the middle of 
an application's resource chain. This problem w;is worked 
around in system 7.5,2 by ft arcing the Finder to load the OSL 
when it started up, thus forcing OSL's resource file to be located 
in the system, where it did no harm, ’this work-around masked 
the profiteni for all .system versions after 7.5.2, fmt tfic problem 
is still there for earlier system versions. 

After the iniroducrion of the Power Maciiito.sh, work Ix^gan 
IO convert the OSL .source ctxle from Pascal lo C. Tills conversion 
wa.s needed in order to t>rovidc a shared library containing liotii 
PowerPC and CFM-()8K code. The converted fat OSL was 
released as version 1.0.4, which w^as included on the E.'PO. CD- 
ROM relea.ses until recently. 

There were a numlxr of problems, liowever, with this 
version of the OSL, the worst of w hich was that a Gestalt selector 
installed by version TO.2 w^ls not being installed by version 1.0A 
This prevenled applications that were testing for Lfiis Gestalt 
selector from detecting the presence of the OsSl shared library^ 

Note: A Gestalt selector is not the Ixst methfxi for detecting 
the presence of the OSL, but this decision was made early in the 
development of the code fragment model and the liabilities of 
using Gestalt were not yet well understood. The preferred 
method w^oukl have been to have developers compare a symliol 
in tlie library to kUnresolvedCiVagSyinlx>lAddrc.s.s. (For details of 
this process, see Technote 1083: Weak-Linking to a Code 
Fnigment Manager-based Shared Library) 

Tlie other major prol^lcm with tliis version of the OSL wa.s a 
number of bugs in the code tliat bandied whose clause 
resolution {in addition to those? previously mentioned). Ihese 
bugs would cause an application to return incorrect resulLs 
and/or error messages when lliey were [)iesented witli valid 
requests. Because of the missing Gestalt selector wliich 
prevented this version’.s iise^ the whose clause resolution bugs 
were not di.scovered until inudi later 
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No Code Changes^ Just Version Chan(;es 

Somewhere between versioas 1.0,2 and L0.4, a mistake was 
made in die build process tor the AppleScript 1.1 SDK which led 
to version 1.0.2 of tlie OSL being released as version 1.1. There 
is no dilference in the actual code, only a new version number. 

This meant we now- had a 1.1 veision which is really older 
tlian version 1,0.4. But installers complain when you try to install 
V 1,0.4 over 1.1 because they think you are replacing a newer 
version with an older one. So when Apple shipped the Apple 
Telecom software version of OSL, 1.0,4 was changed to 1.1.1. 
This allow^ed the installer to replace the old version widi the new. 
Again, no code clianges, just a version change. (All the old 
problems, of course, were still there). 

This is the point where many people started having proldeias; 
we now had a situation where a (generally) weli4>ehaved version 
11 was being replaced with a broken version 111, 

A Valiant Attempt To Fix Things 

The AppleScript team, at this point, decided that enough 
was enough—it was time to move forward and fix things. They 
released a version that fixed the Gestalt selector problem and 
called it 111 But no one had told them about the Apple 
Telecom OSL version 111, so they changed the version tfj 112. 
But, again, someone else had already made a limited release of 
an OSL version 1,12. 

This was unfortunate, but not a major problem—tliey just 
incremented the version to 1.13^ Tliis version, whicl contained 
tile fixed Gestalt selector, got a limiLed developer release. 
Great—now the applieaiitms w Inch couldn't load it i:>efore due to 
die Gestalt selector bug could use the OSL. But when these 
applications loaded the OSL, they revealed all sons of interesting 
behaviors resulting from die OSL's inability to resolve who.se 
clauses (Rememiier that no one had actually executed this ctKle 
before the Gestalt bug w'as fixed.) 

Back to i jil Drawing Board 

Tile AppleScript team started looking at the 10.4/1.1,1 eexje 
stream in more detail and, after considering what a fix niiglit mean 
to the stability of existing apj>l[catioas, it wlls decided that the risk 
of funJtcr trouble was too great, 'llie decision was made to return 
to the older 10.2/11 code stream for the next release* of the OSL. 

As a result, tlic resource-1 (jading source stream in version 
1.0.2 was revised so it could l>e compiled as a native PowerPC 
and crM-6BK library, Ihe resource-loading bug was also 
addressed. 'Phis revised lii>rary was tested, ,sent to a small group 
of devel()fx:rs for further testing, and dien approved for final 
build as version 1.14. 

Along the way^ though, there w^as a new wrinkle added to 
this story. In tjrder to fit in widi the Mac OS reference release 
strategy, die file's creator type got changed, along with with its 
version number, which changed to 116. 

Note: Version 11.4 appears on the Developer CD Series and 
the Mat: OS SDK CD, w'hilc version 11.6 appears on certain 
ET.O. CDs. 

But we still have more to our story. Ii seems that the test 
suite iLsetl to validitle the OSL tested for the presence of the 


Gestalt selector, but did riot determine if it was properly installed. 
Basically, native OSL resource-loading code wasn't doing the 
right thing when it installed iLs Gestalt selector, which could lead 
to crashes in certain situations. 

In the meantime. Version 116 w^as included as part of the 
Harmony (Mac OS 7.6) f3 build dial was seeded to developers, 
Wlien this latest OSL problem was discovered, the decision was 
made to take the version 1.0.2 of OSL and reversion it (again) as 
version 118, Tliis is the version of OSL that is included in the 
CM version of Mac OS 7.6. 

The biggest problem with this version is iliat it isn't fat, as it 
doesn't conrain.s CFM-68K code (rcx:all tliat 1.0.2 didn't, either). 
This wasn’t immediate problem, since Mac OS 7.6 shipped 
wiilioul support for CFM-68K. in fact, 7.6 explicitly checks for the 
presence of the current CFM-68K extension and disables it to 
prevent iLs loading witli diis version of the system. If you can’t 
run CFM-68K, you don’t need a fat OSL. 

A New Hope 

Thanks to the efforts of a number of engineers, the OSL got 
a more thorough rewrite which fixed both the Gestalt selector 
and resourt:e file bugs. Tire testing was completed and the 
problems were resolved. This time, the OSL wa.s released as 
version 1.2, which now generally works as expected. Tl still 
contains the bugs relatetl to whose clause ^.solution, but they are 
not fatal and are easy for developers to work around (see Known 
Bugs in the OSL), 

1'he World As We Know It 

With all tliLs said and done, you’re probably scratching your 
hrad and wondering, '^Wkit version should i lx: using, anyway?” 
At this time (April, 1997) tire answer to that question is (daim 
roil, please): 

You should IX:* using version 12 of the Ohjea Support 
Library, 

ff you don't have acces-s to Uiis version, then use Ll.S (or 
one of its twins, verskrns 10.2 or l.l). Keep in mind that these 
older versions are not fat, which means that they won't work 
with CFM-68K applicaiions. If y<ju need to run a CFM-68K 
application, you must use version 12, 

And, of course, you should install newer version (jf the OSL 
as they are released. 


The History of OSl 
Version Status 

1.0.2...First PowerPC shared library, resource file bug 

10.4 ...New code l^ase, no Gestalt selector, other bugs 

1.1 .....Really just 10.2 in disguise, new^ creator ccxlc 

1.1.1 ....10.4’s twin (wans and all) 

1.12/1.1.3...Never publicly released, so don't look for it 

11.4 .Doesn't work, but released on OS SDK CD 

1.1.6..Version that shipped with Harmony f3 


11.8........Version that shipped with Mac OS 7.6 (another 

1.0,2 clone) 

12 ..Shipped with CFM-68K 4.0; fixes all known 

crashing bugs 
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Known Bugs in tiie OSL 

There are still several known bugs in the OSL, but Lhc 7 all 
have wtjrkarounds. 

Unlocked Handies Passed To Compare Funclions 

You can install an object comparison fcinction tor use when 
resolving whose clauses. Wlien the OSL calls your comparison 
function, it passes pointers to two AEDcscs: one ft>r the object 
lx!ing compared, and one for the objea or descriptor to compare 
to the first. 

'J’he problem here is tliat die memt>ry bleaks containing the 
descriptor records pointed to by the parameters arc located in 
relocatal>le blocks that are not lrx:ked and may move after the 
compare function is called. 

'TTie workaround for this problem is to copy the desttriptor 
records |X)intcd to by the parameters to a local variable as soon 
as you enter the object comparison routine. 

There is a complication to this pro!>lcm involving Classic 
68K applications and the segment loader. If the comparison 
function and the AEObjectSupporttJb.o library are not in the 
same segment when you build your applicaii<in, it's possible for 
die descriptor records to move before they are copied if the 
segment containing the OSL is not already loaded. 

'Ihe workaround for diis prolilcm is to make sure that the 
comparison function and the AEObjectSupportLib.o lilirary are in 
die same segment when you build your application. 

Memory l^eak in Object Comparison Callback Function 
During whose Clause Resolution 

There is a memory leak when the OSL calls an application- 
supplied comparison callback function while resolving whose 
clauses in t^bjeci specifiers. When the OSL passes objccLs to die 
comparison calllyack function, those objects will often Ix^ 
application-defined tokens diat are created by object accessor 
functions. 

The i^roblcin is that the OSL calls AHDisposeDesc on thea^ 
token objects rather than AEDispexseToken, which causes a 
memory leak—any data the application has allaclicd to the token 
Is not pn>pcriy disposed of. 

This problem is further complicated by the unlocked 
handles bug described above. The workaround is to <x)mbine the 
unlocked handles fix with disposing the tokens yourself. The 
pseudo-code Ixlow describes the work-around for this problem 
and also die unlocked handle [iroblem above: 

Pascal version 

function MyCoinpnreObjects( cainpnrisonOpecator: DeecType; 

(CONST) VAR theObject; AEDesc; 

(CONST) VAR objOrDescToCoiciiare: AEDescr 

VAR coapareResult: boolean): OSErr: 

var 

theObjeetCopy : AEDesc: 

objOrDescToCompareCopy : AEHesc; 

begin 

(FirM make copies of tbc descriptors because Uic OSL has them pomtins 
into a felocaiable blodc, which can be moved by the code belt)w.) 
theObjeetCopy theObject; 
objOtOescToCompareCopy objOrDeseToCoBpare; 

I Now SCI the originat dcscipton to the null descriptor since wc haw 
to dispose of the objects below hecau.se of this OSL bug!} 

SetToNuliDeseC theObject ): 

SetToNullDescC objOrOescToCompare ): 

( Code to do the comparison goes here } 


MyConiparcObjects OoIheCoiJip4rifion( conparisortOperator, 
theObJectCopy, 

abjOrDescToCompareCopy* corapareResult ); 

[ lliesc descriptorsi ate jaipposed to be const, but the OSL never calls 
OUT dispose token callback hinaion.so we dispose of them here in 
case one cif il^cm is an applicatiornicfined lokoi.} 

HyDispoaeToken( theObjeetCopy ): 

MyDiypq^eTokenl objOrDeacToComparoCopy ): 

end; 

C version 

OSErr MyCompareObjecteC DeacTypo compacieonOperator* 

const AEUesc 'theObject, 

const AEDesc 

•ob j Or0 escTo Conp are* 

Boolean •conpareHesull ) 

I 

AEDesc theObjeetCopy: 

AEDesc objOrDeseToCompareCopy; 

OSErr anErr; 
theObjeetCopy ibeObjeet: 
objOrDescToCompareCopy == objOrDescToCompare; 

SetToNullDescC theObject ); 

SetToNollDescC objOrOescToCompare ): 
fluErr = DoTheComparison{ comparisonOperator* 
theObjeetCopy* 

objOrDescToCouipareCopy, 

compareReault ); 

MyDlspaReToken{ LheObjeetCopy ); 

MyTJisposeTokeii [ objOrDescToCoinpareCopy ): 

I 

Memory^ Leak in marking Callback Functions During 
whose Clause Resolution 

ITicre is a memory teak when die OSL calls appliaiiiun- 
provided marking fimetions during the processing of whose 
clauses in object specifiers. 

In rhe process of resolving an olijecL .sjxcificn a dest:ripror 
record is c:reated and passed to the mark token callback function 
(as die cooLainerToken parameter) and object-marking callback 
function (as the theToken paramclcr)- The prtjblem is that the 
OSL never disposes of this descriptor, either llirough 
AEDi.sfX)seTt>ken or ARDisposeDesc. 

The problem can lx avoided by having your applicadon 
re.solve all whose clauses it receives on its own. Tliis way ii am 
avoid calling AHResolve. This can be advantageous, especially for 
the most common tyfics of objea .spetriflers. However, you can 
potentially receive “uncommon" objcci s|xcifieirs that are better 
handled by the OSL using your callback funedons; if you handled 
them yourself you*d end up duplicating most of the OSL. 

Fortunately, the workaround for this prt)l)lem Is relatively 
simple: dispose of the descriptor record at die end of die object- 
marking function and set It to a null descriptor. Tliis fix should 
not cause problems if diis l>ug Is fixed in a future release of the 
OSL, since it's always safe to dispose of a null de.scriptor record. 

Function to set descriptor record to null descriptor 

void SfitToNul]fiesc( AEDesc ibeObject ) 
i 

thcObject.descriptorType = typeNull; 
theObject.dataHandle “ nil: 

} 

Furdier Rei erencl 

Tedmote 1083: Weak-Linking to a Code Fragment Manager- 
based Shared library' 
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Newton Q&A:Ask the Llama 


Q: I waul to put my own custom icons in the picker that 
comes up when a user taps the action button. I have a 
slot in my base view called myTestIcon that contains the 
icon ] want to use. But 1 can't figure tiut how to use that 
icon in the array of action frames in the routeScripts 
slot in my application. I started with the folkiwing 
routing item frame based on a simple ‘‘duplicate” action: 

f lit In: •Teflt Actlnn". 
icon: ROK_roiiteDuplicateIccm. 
routeScrIpt: funcltarg^et. targetView) 
begin 

// my funcikm here 
ftnd J . 

This workcxl fine. Then X replaced the icon specification 
with tiiis code: 

icon: GetRootE) ♦ (kAppSyiihol) .myTestlcon, 

But this won't even compile. Any ideas? 


A: The prohleni is that you're using tlie GetRoot function call 
in your array of routing action frames. Since the array of 
frames is in an evaluate slot (that is, the routeScripts slot), 
it will be evaluated at compile lime in the Newton *loolktt 
environment. In other w<)rds, youVe asking the Newton OS 
CO look in tlie root view for your application's l>ase view 
frame. This assumes that your application has iieen 
installed on a Newton device. But the code is executed at 


Cf>mpile tinK% so there is no Newton dev ice» no root view, 
and no base application frame. 

The easiest way to solve your problem is to define a 
constant for the icon in a text Pile and then use that constant 
in the appropriate slot that defines the action. 

Ixa's assume tiiat you already have a resource file with the 
appropriate FlCl* resource, and that you have a text file as 
pan of your project (if not, just create one from the Nl'K 
File menu and add ii to your projea). In the text file, add 
a line that looks something like this: 

DefineGlobalCgnutQTiLrkHylcisii. GetPictAsBltsp’HyTcgn". 
tilU): 

// f4citc; Kurticr vcrskuLs uf Ihv pUrftirm file may use DtlCmist instead 
// of IkfineCifobaJCon^iiaiiL 

This will give you a constant named kMylcon. {Obviously 
you would replace k My Icon with your own meaningful 
constant name and the string “Mylcon” with the name of 
the appropriate PICF resource.) Do lliis for each of the 
action menu icons that you want. Note that even though 
the action niemi calls them “icons." you get the data by 
reading a Macinlosh PICP resource, not a Macintosh ICON 
resource. 

In your applicaiion's routeficripts slot where you create the 
array of extra action button actions, use tlie constant names 
you've created: 


The Ikina is the unofficial mascot of ihe Developer Technical Support group in Apple's Newton Systems Group, Send your Newtoo-related questions 
to dr.ilajiia@nt:wton.apple.com. The first time we use a question from you, we'll send you a T-shirt. 
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I title: "Test Action"* 

Icon: kMylcoti, 

routeScript: func(targets targetView) 
begin 

// ni^ functlofl hcntf 
end*\, 

The other way you can solve your problem is by specifying 
the array of action frame*s at run lime. Instead of specifying 
a routeScripts slot with your array of action frames, you can 
provide a GetRouteScripts method. Since this method lets 
you construct your array of acthin frames at run time in the 
Newton environment, the root view will exist and your 
applicatitm will lx* found. 


Q: rm using a protoLabelInputLme% which IVe used many 
times before* In this case no user input happeits in the 
input line, lire entryFl^s slot looks fine. Ifs set to 
vVisibie, vClickable, vStrokesAllowed, 

vGesturesAliowed, and vAnylhingAllowed. But strokes, 
gestures, and recognition do not occur. I tried adding a 
viewClickScriptt vicwStrokeScript, and 

viewGestureScript. The viewClickScript docs get called, 
but none of the others do. When I remove the 
viewClickScript, there's still nothing. Whats going on? 


A: YouVe fallen prey to a rare gotcha that's hard to find unless 
you know what youVe lcK>king for. The clue is in the 
lx:havior with and without the viewClickScript. Without it, 
tlie line lakes no input, so it appears as if the view is 
ignoring clicks. With it, you see something occurring. The 
key is that the viewClickScript of a clickable view will be 
searched for in ix^ih the proto and the parent chain. So you 
must have a viewClickScript defined in a parent of the 
prott>I.abelInpuiLine. When tlie user puts the pen down in 
the input line, the inherited script is found and eKecuted in 
the context of the input line. This inherited script prnbalily 
turns off the ink and then doe.s some processing. You've 
seen tlie result 

The solution is to add a viewClickScript to your 
protoliibellnputl.ine that returns the value 'skip. This will 
let the protoLalK.‘lInputLinc grab the stroke and allow 
recognition lo happen. Note that simply returning true tn 
nil would not solve the problem. 


Q: The docufnefiCation for StuffLong says it ‘^ites four 
bytes at the specified offset using the 30-bit signed value 
you pass it as a third parameter and sign-exteiids it ti> 32 
bytes.” Ignoring the obvious error (“32 bytes'" should 
read “32 bits”), why dews it take only 30 bits? 1 realize 
the language defines an integer as a 30-bit 
representation, plus a sign bit, but wliat’s bit 31 for? 
More specifically, Imw can 1 ase Stuffixing to result in 
the value 0x20000000? 


A: Hirst off, the representation is not 30 bits plus a sign bit plus 
some other bit. NewtonScript uses a 30-bir two’s 
complement signed represeniaiiort. The other iwo hits are 
used by the OS for other purposes, $o StuffLong takes 
integers as 30 biLs becau.se that's how NewtonScript 
represents integers. In the Idnary o1>ject, the other two bits 
will be the sign extension of the number you pass in, Tlmt 
is, they'll have the same value as the sign bit: 0 for positive, 
1 for negative, 

A,s you can probably see, it isn't possil^le to use StuffLong 
to [)ul yt>ur long word into a [unary ohject. The two high- 
order bits must be the same as the sign of the number In 
your case, you have a I bit in the sign, but you want a 0 
for lK)th l)its of the sign exlen.sion. 

To stuff the data you want, you’ll have to use some 
combination of SmffWord and/or Stuffl^yte. 


Q: I have some compile-time functions that generate frame 
data and some other functions that do sanity checking. 
Is It possible to abort the compile and give an error 
message once NTK has started compiling? 


A: Yes. NTK implements a subset of the Newton environment. 
This includes the ability to throw exceptions. To abort a 
compile, throw an exception. If the exception is of the type 
'1 evtex.msgl, any message you p)rovide will be shown in 
a dialog by N’fK. Here's a simple example: 

thrijgp levt.cx.ma^l, "Invalid data at position " && 

IheIndex): 


Assuming that theindex lias tlic value 4, diis smicment will 
abort the current compile and display a dialog containing 
“Invalid data at position 4," Bi 
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Macintosh Q & A 


Q; FindSyiubol returns a paramErr if I pass it a symbol 
name with a length greater than 64 characters, yet the 
documentation and interfaces specify that 1 pass the 
address of a Str255- What gives? 

A: This is a known t>ug, iind lias txxai fixed as of SysLem 7 5*5. You 
should either make sure the System version is 7.5*5 or later, or 
keep your syrnlx)! name lengtlis lo 64 or fewer characters. 

Q; Any time I try to load a shared library that has a nonzero 
implementation version number with GefSharedLibrary, 
CFM returns a fragTooNew error. Why? 

At This is a hug in CFM Lliat was fixed in System 7.5*5. If you 
need a nonzero implementation version numl)cr, you'll liave 
to be sure lo am only on System 7.5.5 or later. Otherwise, 
make your library's implemenUition version number 0. 

Q; rve been reading the documentatitin on the Resource 
Manager and 1 can't seem to find an unequivocal statement 
about whcthcT resource IDs should be unique within a 
single resource type in a given resource file. Some 
documentation seems to suggest if s OK to have duplicate 
rt^>urcc IDs as long as my program do^iiT expect to be 
able to find resources by ID later. What's the real story? 

A: You’re right; during a recent extensive survey of our 
documentation (Insi^ic Macintosh old and new editions, 
't'echnotes, and so on), we found that some of tlte discussions 
of resource IDs were less than perfectly clear on this topic. 
The real story is dial resource IDs should be unkjue within a 


single resource type within a given resource file. When you're 
adding resources to a resource file, you might want to use 
LlniqueiD or Unique IID to help you find unique resource IDs. 

However, some resource files do eoniain multiple resource.s 
with the same type and ID. This can be due to bugs in die 
program that created the file or to the aforementioned 
ambiguity in ilie documentation. When reading resource 
files your program didn't create, make sure you can 
gracefully handle such files. 

Regardless of wliat you may read in other documentaLion, die 
Resource Manager in some versions of the Mac OS may 
behave unpredictably when reading files that have multiple 
resources widi the same type and ID. 

One easy way to detect whether a given file contains multiple 
resources with die same type and ID is Lo open the file with 
Resorcerer or ResEdit. Tliese programs will warn you if they 
delect this condition. 


Q; What's the logic behind the Create/Update preview 
behavior in the SFPGetFilePreview dialtig? If I create 
previews for QuickTime movies I sometimes get 
preview movies and sometimes get preview pictures. 
With QuickTime movies that already have previews I 
sometimes get an Update button and sometimes get a 
dimmed Create button. What determines the behavior? 


A; PICT flies (or files that Quicklime can import as PICT via the new 
graphic' import components) don't have durations, so they can 
only have a pieview PICT in the Standard File Preview dialog. 
Movies can have Ixidi a poster PICT and a movie preview. 
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when a movie or PICT fflc is selected in tlie dialog, the 
preview component will first see if a pieview already exists in 
the file, stored in a 'pnof resource. The “pnoi' resource also 
identifies whether the preview is a PICT, a movie, or whatever. 
The preview component then compares a timestamp in the 
'pnoi' resource to the mcxJification date of the selected file to 
see if the preview is current. If the ‘pnot' date is older than the 
last modified date of the file, the dialog will show the Update 
button (and will create the new preview with the ^pmak^ 
components if the user selects this option). 

rf no 'pnof resource is found in the selected file, and a ^pmak’ 
comfK:)neni exists dial can cTcate a preview for die selected file 
type (QuickTime 2.5 supplies PICT, MOOV, and QTIf 'pmak' 
componenLs), the Create button will l:>e active in the dialog. 

Note that sound files preview in a slighdy different way. ffie 
'pnot’ components create an automatic 10-second preview (if 
there's tliat much sound) for supported sound file types 
without needing a 'pnot' resource in the file. 

You can read more about preview components in Inside 
Macintaslv.QuickTimc Components. 

Q: I>e saved files to disk in both foreground and 
background printing modes with LaserWriter 8*4*1, and 
the file si^e is always the same* Vd expect the st7.e of the 
background image to be smaller as a result of 
compression and two-pass optiinizations, Wliy don’t I 
get different-si2e PostScript files? 

A: TaserWriter 8*4 (and all other 8.x versions) always saves to 
disk in Iwo passes, licnce the foreground and background 
files you see are the same size. If we didn't do this, we 
would generate non-DSC compliant PostScript jobs w'hen 
saving to disk in the foreground. If you really want to check 
the PostScript code being sent to the printer, you should 
turn on the papToDisk bit in the driver’s Tl<¥S' resource. 
This creates papToDisk files that capture the data going to 
and coming from the printer. 


Q: Tm trying to find a way for my application to determine 
whether if s using a PostScript printer* For performance 
reasons, fd like to send custom PostScript code instead 
of a PICT to tlie printer if I can. Is tliere an API to find 
out whether the currently selected printer is a 
PostScript printer? 


A: There's no good way of doing this. For Apple’s LaserWriter 
drivers, you can, if you must, look at the wDev field in the 
print record of the currently selected printer. Here's a 
quote that’s hidden in Technote QD 10, “Picture 
Comments — The Real Deal”: 

The high byte of tlie piStl.wDev field of the print record identifies 
a printer driver species; a value of $03 tells you riiat the printer 
driver belongs to the PcxstScript LaserWriter driver ancestry... 

However, although die Apple LaserWriter driver has a wDev 
of 3, r>ther printer drivers for PostScript devices may not, so 
diis is not a complete solution for detecting PostScript printers. 
Further, it’s not recommended that you use the wDev field to 
distinguish between printer drivers at all; see the Print Hints 
column in this issue of develop for more on tliis. 

Qi Pm using the code from page 4-l6 of/fisfde Macintosh: 
Processes to animate the cursor at VBL time, but it 
crashed (with the stack crawl indicating SetCursor as 
the culprit). Whaf s up? 

A: When hardware cursor support was added to ihe Mac OS 
(System 7.5.Z for PCI Power Macs), SetCursor started 
requiring A5 to refer to a valid QuickDraw globals world. 
De^>pite die fact that die cxkIc you refer to accesses no global 
variables, your application still needs to make sure A3 is set 
up for SetCursor’s benefit. 

An explanation of setting up A5 in a VBL task can be found 
on page 4-13 of Inside Macintosh: Processes. 

Q; We"re wiitiiig an application that requires us to connect 
to a remote machine via TCP/IP and talk to a background 
application running on that machine* However, we 
cannot connect to tliat niaciiine when if s in sleep mode. 
Is there a way to keep the network services alive when a 
machine Is in sleep mode? Tve seen how you can keep 
the serial port alive, but not the network services* 

A: When a Macintosh (usually a PowerBook) goes into die 
“sleep” state, it's incapable of responding to network 
rec|uests; the connections actually shut down. There are some 
Macintosli computers, however, diat will attempt to go into 
an energy-efficient mode know as “doze.” 


In MAt/TECH 


Macintosh Q & A 


83 







Tht! slcL'p sLaic: Ls e^isy to piwent and is pretty well 
documented in tlie Power Manager chapter of Inside 
Macintosh: Devices under “I'he Sleep Queue” and "Sleep 
Pnx:edures,” and there's more information in Technote 1046, 
"Inside Macintosh: Devices — Power Manager Addenda," and 
Technote 1086j "Power Management ik 'I'he Eneigy Saver API.” 

If you want to prevent the system from sleeping or dozing, 
you should do the following: 

1. Allocate a SleepQKec (preferably in tlie system lieap). 

2. Set it up to call into your sleep handler. 

3. Eeturn a nonzero value from your sleep handler when it's called. 
(Wlien the Macintosh attempts to sleep or doze, your sleep 
handler is called with a sleepRequest or dozeRequest selector.) 

In the doze state, Ojx'n Tfans[>orL networking is still enabled 
and I'CP connections that are set up should still function. But 
it might take severai packets received within a shod period 
{try 10 per second) to wake the machine from its doze state. 
You might also consider pinging tlie machine first to get it out 
of the doze state. Eidier way, il' the machine is dozing it will 
take some Lime for the networking to reactivate, especially if 
virtual memory is enabled and die disk drive must spin up. 


Q; Tm writing a fax client-server system and Tve 
encountered a problem after I put the server to sleep; 
on waking, the server software doesn't seem to 
reregister on the network (using RegLsterMyName)* On 
the client side, when receiving a sleep demand I wait 
until network activity has ceased, then return control to 
the system; the client wakes and reconnects to the 
server with no problems. What action should I take to 
correct the rcfegisteHng problem? 


A: In general, you might want to disable sleeji on your server by 
informing the Power Manager with AuroSleepControl(lalse). 
Otherwise, the clients might never know thai your server is 
sleeping, and theyll Ixf unable to connect. But if you do want 
to suppciii sleep, a server should install a sleep procedure 
through the Power Manager using SleepQInsiall. 

The exact details of how your server should handle sleep 
requests and sleep demands are provided in Table 6-1 on 
page 6-10 of lyiside Macinlmb: Devices. Uliiimtciy, you dose 
and deregister your server from die netw^ork. Later, when you 
get the sicepWakellp rail, you shoukl reopen and reregister. 


Q; I installed a sleep procedure, but the Power Manager 
will issue a sleep demand if the user selects Sleep from 
the Special menu. The AutoSleepControl(false) call will 
stop sleep requests but will it also stop sleep demands? 


A: Your application cannot refuse a sleep demand, as 
dcHumenied in Inside Macintosh: Devices on page 6-11: 

When your sleep procedure receives a sleep demand, 
however, your procedure has no way to determine whether it 
originated as a condidonal sleep demand or an unconditional 
sleep demand. Your device driver or application must prepare 
for the sleep state and return control promptly to the Power 
Manager when it receives a sleep demand. 

For AiitoSleepControl, see Itiside Macintosh: Dances^ page 644: 

When enableSleep is set to false, the computer will not go 
into the sleep mode unless it is forced to either by some user 
action — for example, by the user's selecting Sleep from the 
Special menu of the Finder — or in a low battery situation. 

Q: How do I specify and control Open Transport serial port 
I/O handshaking? Tlie options are a bit confiising. 


A: By using the SRL_OFl'_IlANDSIlAKE option provided by tlie 
Open Iransport native interfaces, you can customize serial 
pon handshaking in a variety of ways. For instance, you can 
request that input handsliaking be con trolled t)y tlie CTS line 
or by the XON/OFF sequence. Tlie default value of this 
option is no liandshaking. 

4he handshaking liehavior is specified by a 4-byte unsigned 
integer value that's pasvsed in with the SHL_ORr_HAMDSHAKE 
option. The higli word (16 bits) of the integer is a bitmap with 
one or more of the following liits set: 

kOTSerlalXOnOffInputHandshake = 1 

kOTSerialXOnOffOutputHandshake - 2 

kOTSetiaiCTSInputHandshake “ 4 

kOTSetialDTROutputHandshake ^ S 

The second lowest byte is the XON chanicter value, and Uic 
lowest byte is the XOFF character value. If these values are 0, 
and XON/XOFF handshaking was requested, die default values 
of Control-S for XOFF and Control-Q for XON will lx: used. 
An inline function (or a macro, for C users) is defined in 
OpenTptSerial.h for creating this 4-hyte value: 

0TSerialliandshakeData{UIntl6 type, UIntB onChar, UIntS 
offChar) 
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Suppose, for instance, that you wanted to enable XON/XOFF 
input handshaking, but you wanted to specify that the XON 
character be Control-T instead of Control-Q. You would 
create an option structure as follows: 

TOption opt: 

opt.leu " VOTFourEyteOpttooSisie; 
opt.level - XTI^GEHERIC; 
opt.naae = SERlAL^OPT^HANDSMStE: 
opt.value “ 

OTSerialHaTidshakeData(kOTSerialXOnOftInputHandshake. 

{'T' 4 -0x40). //normally kOTSerialDefijuliOnCh^ 

kOTSerlalDefaultOffChar): 

You can also control the XOFF state of the serial input port, 
by using the I_SelSerialXOFFSlale locll t:ommand. A value of 
Q will unconditionally clear the XOFF state, while a value of 
1 will unconditionally set it: 

//Set XOFF state. 

OTIoctl(tfaeSerialEndpoint, I_SetSerialXOffStaten 1)j 

The LSetSeriaIXOn locti command causes the serial port to 
send an XON character. A value of 0 will cause it to be sent 
only if weTe in the XOFF state, while a value of 1 will 
unconditionally send the character: 

// LfncofldUionally send an XON character. 

OTloctl(theSerialEndpoint, I_SetS^ tinlXOn < 1): 

Conversely, die LSetSerialXOFF loctl command causes tlie 
serial port to send an XOFF character. A value of 0 will cause 
it to be sent only if we're in the XON state, while a value of 
1 will unconditionally send the chameten 

// Unconditionally send an XOFF character. 

OTloctl(theSerialEndpoint.. l_SeLSerlaiXOf£, 1); 


Q: A friend told me you can make really great water 
rockets from plastic pop bottles. Is this true? 


A: Boy , htjwdy, Ls it ever! To give you an idea of how great they 
are, read tlie article ‘‘Soda Bottle Water Rockets” in Physics 
Teacher magazine, March 1995. Some interesting results from 
the article: If you launch a plain 2-liter bottle, filled witli 0.7 
titers of water (about 1/3 full turns out to be optimal) and 
pumped to 85 pounds per square inch, all the water is 
expelled in 0.07 seconds. At duit pt)int (“burnout”) the lx>tde 
is only about 2 meters off the ground but is traveling at an 
incredible 76 meters per second (171 miles per hour)! Ihat's 
an average acceleration of over 100 g’s! 


Of course, a naked bottle is aerodynamically hopeless, and 
tumbles fluffily after burnout. Bur if you add fins and some nose 
weight to make a stid>le rxxikel out of iL, truly ftnpiessive altitudes 
are passible. A velcxity^sensitive parachute deployment device 
has recendy been concoaed, botde connection technology is 
advancing rapidly, and relial^lc multislage rockeLs are an active 
topic of investigation. Launciiing teclmiques range from the ultra¬ 
simple “cram a cork in it and pump 'til it blows” mediod to 
sophislicated, expensive launchers with all the bells and whistles. 

For more information, see tliese Web sites: 
<http://nnembers.aol.com/aqiiarocket/>, <http://www.H20Rocket.conn/>, 
and <http://wwwilash.net/~berggren/rocket/>. 


Q: If my Web server is running along happUy under 
Open Transport (1,1 or la.l), and the listener is 
bound to address what happens when 

someone uses the control panel and changes the IP 
number? Right now It appears to just make the 
listener go deaf 1 don’t appear to receive eonneetions 
on the new IP number, and if I use the control panel a 
second time to switch back to the original IP number, 
I don’t get connections for that IP number either. Is 
there some event that gets sent to the listener that Fm 
not looking for that tells me when this happens? 

A: When a port changes its IP number, it's actually closing and 
reopening. When Open 'Ifanspon closes a port, any endpoint 
that's plumbed to it is also closed, hence you’ll get no further 
events on that endpoint. 

The first thing you need to do is check for the provider events 
such as kOTProviderWillCiose and kOTProviderisClosed. 

You should also use the OTOegisterAsClient call and register 
a notifier for client events, such as kOTPortDisabled, 
kOTPortEnabled, kOTPortOffline, kOTPortOnlinCj 
kOTClosePortKecjuest, kOTYieklPorlReciuest, and 
kOTNe wPoitRegistered. 

When the interface changes, y<.)u need to close up your 
endpoints and rebind them. 


These atisu^ are sulpHed by the tecbnicai gurus in Apple's 
Developer Support Center. For more ansums, see the Macintosh 
Technical Q&As on the World Wide Weh ai 
hllp://devAnfo.appie.com/techqa/Main.htmL HI 
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by Andy Bacborski and George Warner 


Mixed Up Threads 


See if you can solve this puzzle in the form 
of a diuiog betufeen a pseudo KON (Andy 
Bacborski) and BAl (Gei}rge Warner). Ihe 
dialog gives clues to help you. Keep 
g7^essing until you>e done; your score is 
the number to the left of ibe clue that gave 
you the correct ansu^r Even if you nether 
rttn into the particular problems being 
solt.fed here, youV learn some valuable 
debugging techniques that mil help you 
solve your own programming 
conundrums. And you'll also learn 
interesting Macifiiosh trivia. 

KON So, BAL, IVe njn into a weird 
problem. 1 crash when 1 try to 
compile and ckccuic a scripi 
using the AppleScript Open 
Scripting Architecture 

component from within a 
native PowerPC™ application, 


BAL What's so weird about that? AppleScript hasn't been 
touched in years. It's bound to be showing its age 
by now. 

KON Yeah, sure. Anyway, IVe got an application that 
creates several threads. 

BAL Now youYe throwing the llireaci Manager into the 
mix? 

KON Look, can I just explain the problem? As I said, 
several threads are created, and inside each thread a 
string containing a valid AppleScript script Ls pas.sed 
to the AppleScript component to be compiled and 
executed* 

BAL This one's easy. YouYe using a single AppleScript 
component instanc:e for all the threads. You need to 
have a separate instance fcir each tliread for this 
scheme to work. 


Andy Bachorski (andyb@applecorn) works in Apple's Developer Technical Suppoit answering questions about Apple events, 
Apple.ScripL and the Tliread Manager. In previous lives he worked as a Mac coasuitant and system integrator, sold insurance 
door to d<xjr, was a used-car salesman, wore almost every hat while working at an Apple dealer, programmed CNC machining 
centers, walked the high iron as an iron worker, and wrendied on cars at Scars* Lifetime highlights include marrying his wife 
Linda and being present for the birth of tlieir ehildren Andrea and Colin. 

George Warner (geowar@appiexom) spends too much time searching for liis wandering robot in the halls of Apple’s RfitO 
campus. He suspects die robot is jealous of his way*too-beautifuI*toniany-a<ompuEcuncrd (but did) wife. Otherwise he's kept 
busy aaswering questions from developers about CFM and the Mixed Mode Manager in Developer Technical Suppon. Prior to 
his life at Apple, George shoved mainframes around at TRW and Digital and jumped out of perfectly good aircraft in the Air 
Force. Now he has a life (and a cute wife!). 
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100 KON Wrtmg. Why dorCl you let me finish? inside each 
thread we ask 

for and get an AppleScript component instance. 
Next we call OSACompileExecute to tell AppleScript 
to compile the script text. The thread terminates 
when OSAO>mpileExecutc returns. 

BAL Hmm. If all you're doing in each thread is calling 
OSACompileExecute, how are the otlicr tlireads 
getting time IxTore the first one terminates? 

90 KON Well, the AppleScript component lets you install an 
active function that gets called periodically during 
liic compilation and execution of a script. Normally 
you’d call WailNextEvent to give time to other 
prexesses, but here we call YieldToAnyThread to 
give the other threads time. 

BAL D'oh! ril hel when you install the active function, 
you're passing a ProePtr, and not a UniversalProcPtr. 

80 KON 1 don't think st). T create a new routine descriptor by 
calling NcwOSAActiveProc before installing the 
active function, 

BAI. Well, then, tiic routine descriptor is getting disposed 
of before the AppleScript component uses it, 

KON Gel a life. 

BAL I've got it! Ihe AppleScript component is 68K code, 
and since threads must be created and yielded from 
the same instruaion set architecture, you crash 
when yielding from the aaive function. 

70 KON No, Tve installed a PowerPC routine as the active 
funaion, so 1 am creating and yielding the threads 
from the same ISA. 

BAL Sounds as if the AppleScript component just doesn't 
like to be threaded. 

60 KON No, that’s not it, because I can run as many threads 
as I like with a 68K application. The crash Itappens 
only when the application is compiled as a native 
PowerPC application, 1 told you it was weird. 


BAL 1 guess that means AppleScript and the Thread 
Manager aren’t compatible on Power Macs, 

KON Nope. As long as 1 create only a single thread in the 
native application ii works just fine. But with two or 
more threads, 1 crash with a bus enor. 

BAL Maybe it would help if we knew where it's actually 
crashing. Set a l^reakpoint just before calling 
YieldToAnyTliread in the active funaion. 

KON After setting the [breakpoint, I see that it's crashing 
wiien die second thiead resumes after its fust yield. 

BAL Thafs a strange place to crash. Let's see whafs 
going on inside the thread. I’m going to assume that 
you're opening a valid component instant:e. 

KON Gixxl call, since the diread would bail if it didn't. 

BAL OK, so set a breakpoint on the call to 
OSAO) m pileExcc u te, 

KON Now we see that when the first tliread resumes after 
its first yield, OSACompileExecute returns 

immediately with errOSAScript Error 

(-1753). If I continue and let die second thread 
resume, I crash with a Inis error upon entering the 
second Uiread. 

BAL But you say everything is fine if there's only a single 
thread. Til bet the AppleScript component's A5 
world is getting trashed. Why don't you save and 
restore A5 around the cal! to YieldToAnyThread? 

KON After I add a call to SetCurrentAS before yielding 
and a call to SetA5 after yielding, there’s no cliange. 
Still crashing, same place, same way. Now what? 

BAL Must be an internal flaw in AppleScript. It was 
written before cither the Thread Manager or Power 
Macintosh systems existed. 1 don't think ifs up to 
the task. 
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KON And I say you're wrong. Bui it sure seems like 
someone is getting confused whenever our aaivc 
function is called, 

BAL I thought you seemed a little dazed. 

KON And confused! 

BAL Let’s see what ihe AppleScript component looks like 
l>efore and after it calls the active function. Does the 
appliration still have the DebugStr calls in it? 


BAL Not so fast. WoVe already returned from the 
function, so well need to restart titc application to 
be able to check the stack before and after the active 
funaion Ls called. 

KON And? 

BAL And after we restart the application, the AppleScript 
component might not be loaded at the same place. 
We need the offset of this instmaion in the 
component. 


KON Yes, but that won't do us any gtKxl. By the time we 
hit the breakpoint, the active function has already 
Ix'cn called. 

BAL Then it's time to get our hands dirty with MacsBug. 

KON ril go gel tlic protective gear. 

BAL Very funny. 1 jet's start by seeing if the slack is getting 
munged by tlie call to the active function. 

KON I'm yours to command, 

BAL OK, nin llie application until the first thread is ready 
to return from the active function; then step until 
we're back in the AppleScript component. 

30 KON We're in the component, and here's what you see 
when you disassemble around the PC: 


oomcia 

HOVE.L 

AA.-(A7) 


2F0C 

0072SCIA 

JSR 

•+$1228 

: 00726E42 

4EflA 1226 

00725C1E 

SUBQ.L 

#$2.A7 


55aF 

0072SC20 

HOVE.L 

D6.(A7) 


2F06 

0072SC22 

JSR 

(A3) 


4E93 

0072SC24 

•HOVE.W 

(A7)+.l)7 


3EU 

0072SC26 

HOVE.L 

AA,-{A7) 


2F0C 

00725C28 

JSR 

•+$UBA 

; 00726DE2 

4EBA 11B8 

O07Z5C2C 

EXT.L 

D7 


480/ 

0072IiC2E 

BEQ.S 

•+$0010 

; 00725C3E 

6/OH 


BAL The JSR to the address in A3 is where the active 
function is being called. We need to break just 
fxfore it's called. 

KON Great, ril set a breakpoint at the JSR instruction. 


25 KON m use the thing demd to find out where the 
AppleScript component is loaded. After entering 
thing '"osa * in MacsBug, we see this: 

Displaying Registered Cajnpanenls 

Cnt tRefJ Thi(]gNa»ic Type Sub! Manu Flags KtitryPnt 

050009 (Not yet load« osa ascr appl OOOOOIFE 0O7O59AO 

BAL Tflis gives us the kxation of the AppleScript 
component, and if we subtract tlie caller address 
from ,stack frame, we have the offset we need to find 
tlie insiruaion again. 

KON OK, I've got its offset. I've restarted the application 
and, after locating the AppleScript component again, 
EVe set a breakpoint before the active function is 
called. 

BAL Go until you hit the Irreakpoini; then dump memory 
from the stack pointer before and after die JSR to the 
active function. 

KON Except for the return value frotn the function, the 
stack lfK>ks untouched. Now what? 

BAL So the stack is untouched. OK, let's restart and take 
a look at the registers. 

KON Which ones? 

BAL Let’s start with the PowerPC registers and make sure 
the Tliread Manager is doing the right thing. 
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20 KON We do a register dump at the breakpoints set in the 
active function before and after YietdlbAnyFunction 
is oiled, and the registers look the same* Tlie 
Tliread Manager is doing the right thing. 

BAL 'Phis time we'll clieck the emulated registers. Set the 
l>rcakpoint at the active function c'all, and clieck the 
6BK registers around the call. 


10 KON When we return to the AppleScript aimponcnt in 
the first thread, the emulated 6BK registers contain 
the second thrtrad's values, 

BAL That would explain why AppleScript is crashing. It 
gets back after die call to the active function, but 
when it tries to pick up where it left off, someone 
lias changed its world. 


15 KON Resulted tlie application, ser the break point... we’re 
there. Here's the registers display before the active 
hinction is called: 


68020 Registers 
00 - 00000000 

AO 


0212E630 

Dl 

= 

00000005 

A1 

- 

007275DE 

D2 

1 .. 

00000004 

A2 

- 

0222S3E0 

D3 


ODOOOOOl 

A3 

- 

021674AO 

m 

- 

00000000 

A4 

-■ 

02UE63C 

D5 

- 

00000061 

AS 


02265520 

D6 

- 

00000000 

A6 

= 

OZ156C9C 

D? 


00070000 

A7 

- 

02156CB2 

60020 RegisLers 
DO = OOOOOlOO 

here it 

AO 

is after t 

- 002E2DD2 

Di 

- 

00002QOD 

A1 

“ 

00000017 

D2 


FFFFFIFO 

A2 

= 

O22icoao 

D3 

- 

00000001 

A3 


021674D0 

D4 

- 

00000000 

A4 


0212E6ie 

D5 

- 

0000006B 

A5 

= 

02Z65520 

D6 


OOOOOQOO 

A6 

“ 

02156C:9C 

D7 

= 

00070000 

A7 


02156C86 


It doesn't look good. 

BAL Well, we can ignore DO tlirough D2, AO, and A1, 
becaase theyTe scratch registers and don’t need to 
l>e saved. And we know that a 6 and A7 will cliange 
as the application runs. That still leaves a lot of 
registers dial aren’t what they should be. 

KON So who's twiddling our registers? 

RAl Ixjt's do the drill one more time, but diis tiinc well 
look at the registers an>und die call to the active 
function for both dircads. 


KON Now we know what’s happening, but not why it's 
happening. We need someone to pin dds on. 

BAL So far we know tiiat everything’s fine in a 68K 
application, And weTe OK with a single thread in a 
PowerPC application, but when there’s a second 
thread weVc got problems, 

KON Right. And since we know that the emulated 68K 
registers are changing behind AppleScript's back, it 
must be the Mixed Mode Manager’s fault 

BAL I’m noi so sure. Tlie Mixed Mmle Manager is only 
responsible for transitioning iTeiwccn ISAs and RTAs 
(nintime architectures). It’s up to the emulator to 
mainuiin die emulated registers, which are stt>rcd in 
a single emulator context block, 1 diink this is 
causing problems for die Thread Manager. 

KON What are you talking aboud The Tliread Manager 
doesn’t have anything to do with the emulated 68K 
registers. Besides, the application works \nsi fine 
when it’s compiled as 68K code. 

BAL It does, but when you have a 68K appliotion, you 
have 68K threads and a 68K AppleScript 
component. In this envininmcnt, the registers all get 
properly protected, 

5 KON The thread Manager saves registers regardless of 
the ISA or RTA of the application. 


KON Fve stepped through the calLs to die active function, 
again. 

BAL And? 


BAL Right, but 1 think what we have here is a nasty 
interaaton between the Tliread Manager and the 
68K Emulator. The root of the problem is the single 
emulator contexi block where die emulated 68K 
registers live. 
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KON Let*s see. Inside the thread die AppleScript 
component (68K) calls the active function (PPC 
code) which causes a mode switch. Now we're in 
native mode with the emulated re^Lsters lying 
dormant in the emulator context block. At this point 
the AppleScript component is assuming that the 
active function it just called will preserve any 
nonvolatile registers it touches. 

BAL Next the active function calls YieldToAnyThread; the 
Ihread Manager saves a PowerPC thread context 
and goes to tiie next thread. But 

the Thread Manager doesn't know anything about 
the AppleScrijit component needing the emulated 
68K registers preserved during the thread switch. 

KON So now die second thread gets control, and it fills 
the emulated 68K registers with its own values. 
Another yield happens, and we get back to the first 
thread. But tiie single emulator context bkx^k now 
contains register vulues from the previous tiircad. 

BAL And since that's not what the first thread ts 
expecting, it dies a terrible deatii. Let’s ihmw 
together a little hack that we can use to test your 
theory. First create a couple of inline 6BK routines 
that save and restore the registers. 

static UTntl6 SaveRegisterHackH = 1 

0x48d0* OxlcfS. //rra^vcm.l d5-tn/a2a4ia01 

0x4e75 //rts 

I; 

atatlc Ulntlfe ReRtareRGgiaterHackt] = I 
Ox4cdO, Ox 1 cf 8, // mwcml (a0),d3-d7/a2'a'( 

0x4e75 //ri* 

I; 

KON That's really skanky. 1 like it! 

BAL Now we need some procedure information, so we 
can call these routines, 

en uin I 

ufjpRegistcrHackProcInfo “ kRegisterBased 

I RECISTER_R0UTTNK_PAKAMJ5TER(1. kRegieterAO. 

SI2E_C00Elsixeof(Ptr))) 

1^ 

KON Check. 

BAL Now in the active function add a call to 
SaveRegisterHack before calling YieldToAnyThiead 
and a call to ReslorcRegisterHack after the yield call. 


long reg6SK[&]: 

CallUniversalProc((UniveraalProcPtr) ASaveReglsterHack* 
uppRegisterHackProcInfo, reg68K}; 

YieldToAnyTlire^dtJ; 

CallOniversalProc((UniversalProePtr) SRestoreRegisterHack* 
uppReglfiterHackProcIiifo, reg68K); 

KON Don't we need to create a UniveisalProcPtr before 
calling the register hack routines? 

BAL No. Remember, a 68K ProePtr is a valid routine 
descriptor. Just call that sucker! 

KON Cool! 

BAL Here’s where the rubber meets the road. Let’s run 
the applitration now that weVc got the registers 
protected. 

KON Bingo. It ran all the way through without a crash. 
Tliat proves our theory. You know, tlic problem is 
really that the Tlircad Manager was designed to 
function in a homogenous application context, but 
in a case like this we're abusing it with cross- 
ISA/KTA callback functions it doesn't expect. St> it 
needs our help to keep everything straight, 

BAL Too bad the Imck we put together is so ugly. Fd 
never want to use something like that in my code. 

KON You don’t have to! Llirough special arrangements, 
BalKon Industries is able to offer on this issue's CD 
not one, hut two, library routines you can link into 
your aiiplication to work around tiie atrtive function 
problem, as well as a similar problem when 
installing send functions in a native application 
using the AppleScript component. 

BAL Nasty. 

KON Yeah. 


SCORING 

80-100 And I'll bet your code compiles and runs the first try, 
45-70 You're an asset to your company; ask for a raise. 

25-40 Not too bad, but keep your resume updated just In case. 
5-20 At least you're honest. 


Tfjanks to Eric Aftderson, Bo3B Johmon, Jon high, Quinn 
^TheEskimor, KON (Konstantin Othmerl ami BAL (Bruce leak) 
for reimving this coluntn^ iQ 
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CodeWariior 
Professional Release 1 

by Metrowerks 


More platforms, more languages, more options: CodeWarrlor 
Professional Is designed to give you the tools you need for 
serious, industrial-strength programming, CodeWarrlor 
Professional is the only Integrated Development Environment 
(IDE) in which you can edit, compile and debug C, C++, Pascal 
and Java programs tor muttiple target processors and operating 
systems, CodeWarrior's compilers produce fast, highly 
optimized code for Windows 95/NT running on x86, or Mac OS 
running on 68K or PowerPC processors, CodeWarrlor 
Professional features the new CodeWarrior IDE Version 2, 

The newly revamped Project Manager supports multiple 


projects open simultaneously, multiple targets per project, and 
tinreaded execution, plus it's significantly faster, CodeWarrior 
Professional also includes online books, documentation, and 
reference materials, as well as tutorials and sample code. We 
support your development efforts with one free update and free 
world-class technical support for a year with registration, 

• Includes Windows 95/NT and Mac OS versions 
of the CodeWarrior IDE 

• Supports C, C++, Pascal and Java 

• Develop for Windows 95/NT on x86 and Mac OS on 
68K/PowerPC from either version 

• New Project Manager supports multiple open projects, 
subprojects, multiple targets per project, and threaded execution 

• Integration of tools means you spend less time navigating and 
more time coding 

(SCWPRO) Our Price $599 

Upgrade for competitive product owners 
(SCWPRUP) Our Price $449 
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CodeWarrior for PaImPilot is the first 
complete set of tools which enables you to 
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the comfort of your PC or Macintosh computer, All the tools you 
need are included; the award-winning CodeWarrior IDE, compiler, 
linker, source-level debugger, GUI builder, and other tools, plus 
online documentation and reference materials. Includes one year of 
product updates and free technical support, 
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• Start programming for the new, innovative Be Operating 
System (BeOS) with complete set of Codewarrior tools 

• BeOS-native Integrated Development Environment (IDE) with 
all the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax 
color and styling, and a source-level debugger 

• BeOS header and libraries, complete documentation, useful 
C++ classes, and sample code 

• The Be Operating System Advanced Access Preview Release 
allows you to run and program for the BeOS on a 603 or 604 
PCI based PowerMac 

(SCWFB) Our Price $149 


Be 
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Codewarrior Latitude 

by Metrowerks 

Don't throw away the investment you 
have made in your Mac OS applications! 

With the DR/1 release of CodeWarrlor 
Latitude, you can prepare your 
Macintosh applications to run native under Silicon Graphics IRIX 
or Sun Solaris (and soon, Rhapsody). Begin work now to 
prepare your Mac OS application to run native under Rhapsody, 
By compiling and linking your CodeWarrior project with the 
Latitude libraries, you can identify which portions of your code 
will port smoothly and which Mac Toolbox traps are not 
implemented. Additionally, you can expand the market for your 
Mac OS application by completely porting it to Silicon Graphics 
IRIX or Sun Solaris at a fraction of the cost of other porting tools. 
As the Rhapsody API evolves, so will Latitude. Registered users 
of CodeWarrlor Latitude will receive all developer releases, the 
first full release, plus one additional product update, to ensure 
that you have access to the most up-to-date Rhapsody porting 
tools available. 

(SeWUT) Our Price $399 


CodeManager 4 

by Metrowerks 

• Source code control system, plug-in to 
the CodeWarrlor IDE 

• Compatible with Microsoft Visual 
SourceSafe version 5.0 

• Cross-platform support (Mac, 

Windows, UNIX, OS/2) 

• Configuration management in excess of 4 billion files 

• Over 8,000 files and sub-projects in a single sub-project 

• Registered users receive one year of free technical support and 
two free updates 

(SCDMGR) Our Price $399 
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Discover Programming 
with Java 

by Metrowerks 

Discover Programming with Java is a 
professional Java environment, 
providing the most complete toolset 
available on the Macintosh. All your 
projects can be built from the ground 
up with the award-winning 
CodeWarrior Integrated Development 
Environment (IDE), which boasts a full-featured editor, a Sun- 
validated Java compiler, a source-level debugger and a Java class 
browser. Preview your Java programs using the applet viewer, which 
is conveniently linked to the debugger for easy testing. 

• Full Java toolkit: project manager, linker, editor, class browser, 
source-level debugger, applet viewer and more 

• Includes an online book, plus online documentation, reference 
materials and tutorials 

• One year free technical support with registration 
(SCWDISCJAVA) Our Price $79 



_ 0 _ 

Newton Toolkit 1.6 m 

by Apple Computer, Inc. 

With Newton Toolkit, you can easily create software that runs on any 
Newton PDA, including Apple's MessagePad and Motorola's Marco. 

• Now supports Newton 2.0 

• Dynamic Language Eases Development 

• Allows you develop applications interactivety 

• New Compiler Enables Faster Applications 
Newton Toolkit 1.6 
(SNETO) Our Price $149 
Newton Toolkit Update 1.6 
(SNETOUP) Our Price $29 


^ Apple Dylan 

Apple Dylan Technology Release 

by Apple Computer, Inc. 

• Contains a PowerPC-native prototype version of a development 
environment based on the Object Oriented Dynamic Language 
(OODL) Dylan. Developers will be able to produce code targeting 
both 680x0 and Power Macintosh systems 

• Automatic memory management 

• Application framework and user-interface 
& builder 

• High-level exception handling 

• Cross-language support for C code and APIs 
CD & Online Documentation 

(SADTRO) Our Price $39.95 
CO & Hardcopy 

(SADTRH) Our Price $59.95 



Newton' 


Discover Programming 
for Macintosh 

by Metrowerks 

Discover Programming for Macintosh 
provides everything you need to start 
and complete your programming 
education. Full-teatured, award-winning 
CodeWarrior tools allow you to build 
full-blown 68K Macintosh applications. 
Powerful reference material and online 
books, including Learn C on the Macintosh, Learn C-t-i- on the 
Macintosh by Dave Mark, and Jim Trudeau's Programming Starter 
Kit for Macintosh are included on the CD-ROM. Plus, the book 
examples have been converted to Apple Guide files for help that is 
just a mouse-click away. Loads ot source code is also included to 
help get you started on the road to success. 

• CodeWarrior Integrated Development Environment (IDE) with C, 
C-M-, and Object Pascal compilers for 68K Mac OS 

• Includes four online books, plus online documentation, reference 
materials and tutorials 

• One year free technical support with registration 
(SCWDISCMAC) Our Price $79 


Newton Toolkit 1.6 for Windows 

by Apple Computer, Inc. 

With Newton Toolkit, you can easily create software that runs on 

any Newton OS device from Apple or its licensees. The Newton 

Toolkit is a development environment that reduces the complexity 

and time involved in creating great software products. 

• Provides access to features specific to the Newton 2.0 OS - Allows 
developers to create new or modify existing Newton applications to 
take advantage of powerful Newton 2.0 OS features 

• Supports Windows 95, Windows I'fT 3.5x, and Windows 3.1 (with 
Win32s) operating systems -Enables developers to use multiple 
development environments/operating systems when creating 
Newton applications 

• Includes Macintosh-to-Windows NTK project converter tool - 
Allows developers to automate conversion of exisbng NTK projects 
kom Macintosh platform to Windows platform 

• Provides NS Debug Tools - Allows developers access to interactive 
Newton application debugging tools. Offers extended NewtonScript 
debugging functions, which let developers study and manipulate 
an application running on a Newton device. Developers can use 
NS Debug Tools to set break points In an application after it’s been 
compiled and installed, step through program execution, examine 
and change objects on the Newton, and diSfrtay a textual 
representation of the interpreter instructions 

(SNETOW) 0urPrice$149 
Newton Toolkit 1.6 Update 
(SNETOWUP) Our Price $29 
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MkUnux: Microkernel 
Linux 

for the Power Macintosh 

by Prime Time Freeware 

MkUnux is a native port of Mach 3 and 
the Unux 2.0 kernel, complemented by hundreds of commands 
from BSD, GNU, and X11. It runs on most (NuBus abd OCU bus) 
Power Macintosh systems; Performs, PowerBook, and 
multiprocessor ports are currently under development. 

MkUnux is robust, powerful, freely distributable, and source code 
compatible with most other Unux systems. It provides a full ^ite 
of development tools, support for AppleTalk, HFS, and Objective- 
C, and access to a vast amount of free software. MkUnux Is a 
great way to ‘come up to speed" on Mach, UNIX, and Rhapsody. 

• MkUnux user community supports FTP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple sponsored reference release contains a wealth of 
introductory and reference material on Unux, Mach, NeXT, and 
the Power Macintosh 

• Includes free 3.0 upgrade 
(BMKLINUX) Our Price $50 


Check out our Web site! 

Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


Pro Fortran 

byAbsoftCoiporation 

Absoft Pro Forfran combines native F90. VAX compatible F77, and 
C/C++ compilers into a single, easy to use environment. All compilers 
^e link compatible and operate through a common interface. 

• Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory allocation and new control construct 

• F90 is link compatible with Absoft F77, C++, MrC and 
CodeWarrior 

• It is fully compatible with Toolbox, MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 

Order Tcll'free 
SOO'MACDEV'I 

|K»<)2?33tl| 


VIP-BASIC: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can create full-featured, stand-alone 

Macintosh and Power Macintosh plications in standard BASIC code! 

VIP-BASIC 2.0 is the fastest way to program your Macintosh. 

• Rapid application development environment with application 
framework, mix and match: VIP-BASIC high-level subprograms 

• import pre-existing BASIC code: automatically integrate BASIC 
code, export C Code for compiling; automatically convert your 
BASIC code to C for compilation with Metrowerks' CodeWarrior 
(SVIPBASIC) 0urPrice$195 


Macintosh Common Lisp 4.0 

by DIgItool, Inc. 

Macintosh Common Lisp provides users 
with a rich set of object-oriented dynamic 
language features making it especially 
well-suited for rapid prototyping, custom 
development for business and education, 
scientific and engineering applications, and academic research. 

• Power PC native environment & compiler, full Macintosh support 




ViP-C: 

Visuai interactive 
Programming in C 

by Mainstay 

Now you can create full-featured, stand¬ 
alone Macintosh and Power Macintosh applications in just minutes. 
VIP-C 2.0 is the first rapid application development system for 
creating complete Macintosh programs in standard ANSI C. 

• Includes powerful, tightly integrated visual debugger. Import pre¬ 
existing C code: automatically integrate C code with a current project 

• Includes full-featured mini database; (ltd to 32K) of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-free, multi-user database applications 

(SVIPC) Our Price $295 



• CLOS, the standard Common Lisp object system 

• Interactive dynamic environment, multiple processes 

• Automatic memory management and self-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiles with Common Usp industry standard and smart 
programmable tools, 110+ mb of user contributed code 

• Complete on-line documentation (manual sold separately) 

• Software license and registration card 
(SMCLISP) Our Price $675 


4 1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 


















ObjectMaster 
Professional Edition 

by Altura Software, Inc. 

Object Master is an innovative programming environment that 
provides all the necessary tools to write, organize, and navigate 
through source code. 

• Write code using the most robust source code editor available 
on the desktop 

• Organize source code Into projects to quickly access and 
manipulate all files 

• Navigate through source code using intuitive graphical 
Browser windows 

(SOMPE) Our Price $399 



Roaster 

by Roaster Technologies. Inc. 

Roaster Release 3 is now available 
and shipping! Get the most out of 
Sun's Java™ programming language 
with this powerful development 
environment. 

• Features include: ability to build 
completely stand-alone Macintosh 
applications or applets; visual interface builder; ability to create 
cross-platform zip files; powerful Java debugger; wizard for quickly 
creating Java applets or applications; JDBC included; Java object 
database included; ability to call AppleScripts from Java; Just-in- 
time (JIT) compiler; JDK 1.0.2 suppcrt; Class tree and hierarchical 
class browser; much more! 

• Software includes: Over 300 example applets and applicabons; 
Netscape Internet Foundation Classes; Object Design's PSE for 
Java; OpenLink Software’s JDBC Drivers: OpenSpace Java Generic 
Library; Microline Component Toolkit Lite 3.0; much more! 

• Requirements: Runs on 68k or PowerPC, CD-ROM 

• Price includes all web-based updates 
{SROAST3) Our Price $49 



NS BASIC 3.6 
for the Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation 
of BASIC programming language 

• Runs entirely on the Newton - no 
host is required 

• Create files, access the built in 
input and output 

• Work directly on the Newton, or through a connected Mac/PC 
and keyboard 

• Get the BASIC Internet Tool, available at no charge to NS BASIC users 
from www.nsbasic.CDm 

• Release Notes with sample code are available from the same locafion 

• Runs on any Newton MessagePad 130 with NS BASIC and the 
Newton Internet Enabler. Also runs on MP 1201s with NOS 2.0 that 
have full memory available 

• Write short programs to access News, mail and the web 
(SNSBASIC) Our Price $99 



soups, and the serial port for 
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CodeBuiider 

by Tenon Intersystems 

CodeBuiider is a powerful and unique Macintosh software 
development toot for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C-f-i-, 
Objecbve-C, Java, Ada. and Fortran development tools 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C. and 
C, C++. Ada 95 and Fortran 77 

• Web & internet scripting tools; Pert, MacPerl, tcl/B<, bash, sh, and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) 0urPrice$149 




WAIT ^ 

Th*'*.*) Here’s a list of all available products. For full product descriptions 
please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

LPA MacProlog Developers Edition 

SLPAD 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

495.00 

LS Fortran Pro 

SLSFORT 

595.00 

LS Fortran Plug-In 

SLSFPI 

199.00 

Mac FORTRAN II 

SF0RT2 

595.00 

Power MachTen-UNIX 

SM10PPC 

695.00 

Presenting Magic Cap 

BPRESMAGIC 

15.25 

SmalltalkAgents 

SSTA 

695.00 

Think Pascal 4.0 

SPASCAL 

165.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C++ classes for integrating 
Internet e-maii in your applications 

• Helps you write software that 
can share mail with other leading 
e-mail products 

• Royalty-free MIME, SMTP, and 
POPS APIs 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 

r-tree Report Generator 

by Faircom 

Handles virtually every aspect of report 
generation: 

• Complete C source 

• Complex multi-line reports 

• Multi-file access 

• Complete layout control 

• Conditional page breaks 

• Nested hleaders and Footers 

• Horizontal Repeats 
(SRTRG) Our Price $445 

Spellswell Plus 2.1 

by Working Software 

• Award-winning, comprehensive, practical spelling checker that 
works In batch mode or within applications that Incorporate the 
Apple Events Word Services protocol (e.g., Eudora, WordPerfect, 
Communicate!, and InfoDepot) 

• Checks for spelling errors as well as common typos like 
capitalization errors, spaces before punctuation, double word 
errors, abbreviation errors, a/an before vowel/consonant, etc. 

• MacTech orders include developer kit with Wrfteswell Jr, a sample 
AppleEvents Word Services word-processor and its source code 

• Avaliable tor OEM Sales 
(SSPELL) Our Price $49 

c-tree Plus® Database Handler 

by Faircom 

Unsurpassed Cross Platform 
Tools for Mac Developers! 

• Full C Source 

• Client/server Option 

• Over 16 years proven 
reliability 

• Concurrent simultaneous access of Mac/PC files 

• Superior throughput and performance 

• Unparalleled scalability and flexibility 

• Fixed/Variable length files 
(SCTPDH) Our Price $895 





Memory Mine 

by Adianta Inc. 

• Monitor heaps, identify 
problems such as 
memory leaks, and 
stress test applications 

• Acfive status of 
memory in a heap is 
sampled on the fly: 
allocation in non- 
relocatable ptr), 
relocatable (Handle) and 

tree space is shown, as are heap corruption, fragmentation, 
and more 

• Allocate, Purge, Compact, and Zap memory lets users stress test 
all or part of a program 



(SMEMMINE) Our Price $99 


ScriptDemon 

by Royal Software, Inc. 



ScriptDemon is a browser plug-in that, for tine first time, allows you 
to deliver and run AppleScripts from Web pages, TTne Scripfflemon 
plug-in will execute the embedded AppleScript code included on a 
Web page, Scripfflemon painlessly and ine)q3ensively handles many 
previously impossible tasks, such as: 


• Using the Intranet to manage all Macintosh computers on-line 

• Using the Internet to install and configure software 

• Using the Internet to configure hardware 

• Delivering complex sets of flies and assembling them on the 
browsing computer 

• Providing interactive education and product support on both the 


Internet and Intranet 
• A perfect companion to LiveCard! 
(SSDEMON) Our Price $949 


Guide Composer" 1.2 

by StepUp Software 


glipup 

SOFTWARE 


• Create powerful Apple Guide help systems for any new or existing 
Macintosh application 

• Provides a WYSIWYG development environment: Guide content is 
developed In Guide windows 

• Design topics, phrases, and panels in the same tonmat as the user 
will use them 

• Feabjres are WYSIWYG interface. Topics, phrases, and 
hierarchical phrases. Coach mate, Fully-Integrated with Apple's 
Guide Maker (distributed with Guide ComposeO, compiles scripts 
automatic^ly, PICTs in Panels, Generated Guide scripts are modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http://www,guideworks.com/ 

(SGCOMP) Our Price $99 

SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman's 

AppleGuide Starter Kit, Real World AppieGuide 
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VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Smooth integration with Metrowerks CodeWarrior IDE 

• Support of AppleEvents and AppleScript 

• Comparison of files of different types (not only text files) 

• Configurabfe local file locking (Finder flag or ckid resource) 

• Improve handling of focal files includeing the creation of folder 
structures 

• Significant performance improvements in many places 

• Essential parts PowerPC native 

• Version control tool for the simple and clear management of 
projects in which files are created in numerous versions (variants 
and revisions) 

• Allows both variant and revision control, and it manages not only 
variants and revsions of single files, but of a whole software 
project (multi files, multi users, multi-variants, access rights, etc.) 

• Graphical user interface and is not only suitable for mere source 
code conbol but can handle all different kinds of files witfi amazing 
compression rates: typical size of delta between arbitrary files 5% 

• Please note special prices for multiple copies: 

Single license (SVOODOOl) $229,2 pack (SVO0D002) $359; 
5 pack (SV00D005) $799.10 pack (SVOODOOl 0) $1389; 

20 pack (SV00D0020) $2399 
Additional pricing available on request. 

SE RELATED CATEGORY: Dev. Environments 


StoneTable 68K/PPC 

by StoneTablet Publishing 

• StoneTable is a replacement for the Macintosh List Manager 

• Available for use with ITiink C, MPW C & Pascal, CodeWarrior 
C and Pascal 

• Includes libraries for 68K and PowerPC 

• An LTable-like class is provided to incorporate StoneTable into 
the PowerPlant environment 

(SSTONEAT) Our Price $199 


QC 

by Onyx Technology 

High performance runtime stress testing for applications. 

• Tests include heap checks, purges, scrambles, handle/pointer 
validation, dispose/release checks, write to zero, de reference 
zero as well as other tests like free memory invalidation and 
block bounds checking 

• Extremely user friendly - ideal for non-programmer testers 

• Also available in Japanese 
(SQC) Our price $99 


AppSketcher 1.0 
for BeOS 

by BeatWare, Inc. 
AppSketcher is the 



BeatWare 


premier programming tool tor the BeOS. 

• The fastest way to develop software on the BeOS 

• Drag and drop design is great for aeating user interfaces 

• Supports localization for worldwide sales 

• Expands applications easily without manual code 
modifications 

• Shortens development time by automating the Make process 
through direct communication with the BelDE 

(SASFB) 0urPrice$199 


MacA&D 6.0 

by Excel Software 

MacA&D combines the capabilities of 
MacAnalyst plus additional detailed design, 
code generation and code browsing 
features into one Integrated application. It 
automates structured analysis and design, 
object-oriented analysis and design, state 
modeling, task design, data and screen 
modeling, code editing and browsing, 
reengineering, requirement traceability and a multi-user data 
dictionary. It generates SQL from data models. C-n- or Object 
Pascal from class diagrams and C, Pascal, Basic or Fortran code 
from structure charts. 

• Structured analysis and design 

• Object-oriented analysis and design 

• Real-time and multi-task design OnCf TolMr$6 

• Data and screen modeling SOO-MCMV-I 

• Integrated code editing and browsing |t^22]3St) 

• Multi-user dictionary and requirements 

• Code to design diagrams for C, C++, etc. 

• Design diagrams to code for C, C++, etc. 

• State modefing diagrams and tables 

• Use cases with traceability 
(SMACADP) OurPrice $1995 
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Apprentice 6 

by Celestin Company 



Apprentice 6 is a high-quality CD-ROM collection of over 600 
megabytes of up-to-date source code, utilities, and info for Mac 
programmers. All of the source code and utilities are completely 
new or updated for this release. 

• Frontier 4.1. the highly-acclaimed scripting environment 

• More PowerPlant AND many more PowerPC samples 

• Cool new languages and environments added (Clean, Eiffel, F, 
Tct-Tk) 

• Hoi new demos from leading Mac development companies 
(SAPPRENT6) Our Price $35 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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SoftPolish CD-ROM 

by Bare Bones Software 

• Tbe essential tool for software 
quality assurance on Hie 
Macintosh 

• Helps you identify 
inconsistencies with Apple's user 
interface guidelines, misspelled 
words, missing resources, and 
other mistakes 

• Provides tools to put the finishing touches on software distribution 
packages prior to release 

• Works independently of any programming language or environment 

• Ideal for sanity checking software throughout the development process 
(SSOFTPOL) Our price $99 





Future Basic II 

by Staz Software 

FulureBASlC II is award winning 
leader In Macintosh BASIC 
programming. 


• Source level debugger and Interactive compiler/editor 

• Multi-file Project manager and Multi-file find and replace 

• Super fast compilation, 32 bit clean, and System lx savvy 

• QuickBASIC converter 

• Getting Started manual with over 500 example files 

• Full support of standard BASIC 
(SFBASIC2) Our Price $229 


AppMaker 

by Bowers Development 

• Develop the user interface for a 
Macintosh application using the 
original interface builder 

■ Just point and click to design 
your application 

• Creates resources and generates 
excellent source code 

• Supports most development 
environments including Metrowerks, Symantec, or MPW; C, 
C-r-r, or Pascal; procedural or object-oriented, using 
PowerPlant, TCL, or MacApp 

• The generated code uses the Universal Headers to provide 
PowerMac compatibility 

• Great tool for beginners to learn object-oriented and 
Macintosh Toolbox programming techniques 

• includes one-year subscription on CD and hardcopy 
dxumentation 

(SAPPMAKE) Our Price $299 




• True relational database system for Apple Macintosh computers 

• Provides a powerful choice for developers who want to create 
database centered applications witii no performance trade-offs 

• Features SQL, full transacfion control, error recovery, single user, 
client server architecture and multi-platform support including 
DOS, Windows, OS/2 and UNIX 

• The C/C-(-t- API is identical and fully portable across all supported 
platforms 

• Third-party vendors supporting dtF will be able to offer a variety ol 
advanced features and benefits to their customers royalty free 

• Tools are included for importing, exporting, creating and managing 
databases and users 

• Supported development environments include: Symantec, MPW, 
Metrowerks and more Mac/SDK 

(SOTF) Our Price $695 


B-Tree HELPER 2.2 

by Magreeable Software 

• Inexpensive database engine 
tor Macintosh programmers 
in C source code 

• Uses contiguous fixed length 
blocks 

• Expands ttie file as necessary and contracts files when 
possible 

• inserts and deletes keys in one or more B-Trees 

• Finds keys equal to, less than, or greater than a given value 
In a few hundredths of a second 

• Rnds lists of records whose keys are equal to, less than, or 
greater than a given value or are in a range of values 
(SBTREE) Our Price $149 



Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer “atoms" that let developers incorporate 
graphics, sounds, file compression and custom folder icons into 
installation scripts 

• Compression formats supported are Compact Pro & Diamond 

• Each atom also available separately 

• Compression requires additional licensing 
(SINSTALL) Our Price $219 

ScriptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp’s InstailerPack, Stuffit decompression, Compact 
Pro decompression, custom packages, splash screens, network 
installs, and resource installation 

(SSCRPTGEN) Our Price $169 
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Water's Edge Software 



Tools Plus libraries + framework 

by Water’s Edge Software 

Easily create compact, fast mnning, professional looking applications and 
plug-ins*. Tools Plus lets you create virtually any user interface element 
with a single routine, and it transparently provides a rrtrust infrastructure 
to make all your pieces work together as an application. Rated 4 stars by 
Macworld! MacTech {July 96): "it’s an incredibly rich collection of tools... 
If you are interested in developing appiications that have 'quality' written 
all over them, then Tools Plus is for you." 

• Simplifies programming and thins source code 

• Automates all standard GUI elements 

• Thousands of extras, from floating palettes and tool bars to 
powerful picture buttons 

• Includes numerous 3D grayscale options 

• Over 1/2 MB of custom fonts, icons, cursors, and other resources 

• Includes SuperCOEFs world-class controls {an $89 value) free 
{STOOLCW) Our Price $249 

CodeWarrior Gold (C/C++ & Pascal, 68K & PPC) 

(STOOLCWB) Our Price $199 
CodeWarrior Bronze (C/C++ & Pascal, 68K) 

(STOOLSYMT) 0urPrice$199 

Symantec (THINK) C/C++ and THINK Pascal (68K) 

(STOOLSYM) 0urPrice$149 
Symantec (THINK) C/C++ (68K) 

(STOOLPAS) Our Price $149 


Order Tdl'lree 
tOO««UCD!V-l 

IOOi?J33«l| 


Te$t1k"ack-Bug l^acking the Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test configurations, users, and more 

• Includes notifications, security, a powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, documentations staff, and project 
managers together to ensure all bugs are identified, fixed, and 
documented 

• Eliminates the need to build custom bug tracking solutions using 
general purpose database tools 

• Supports single- and multi-user bug databases (additional licenses 
required to use multi-user features) 

(STETR) Our Price $129 


THINK Pascal (68K) 

'CtodeWarrior required to write plug-ins 



CodeBuilder ’^TENON 

by Tenon Intersystems inijrsvstims 



CodeBuilder is a powerful and unique Macintosh software 

development tool for porting existing apps or developing new. 

advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C. C-++, 
Objective-C, Java, /\da. and Fortran development tools. 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C++. Ada 95 and Fortran 77 

• Web & internet scripting tools; Perl, MacPerl, tcl/tk, bash, sh, 
and csh 

• Supports Rhapsody kernel /W’ls and Rhapsody TCP sockets 
(SMIOCODEB) Our Price $149 

Phyla'": Object-Oriented 
Database 

by Mainstay 

•Powerful Databases Without 
Programming; Phyla handles your all 
your complex database needs 
•Define a Database in Minutes; Using 
an intuitive, graphical user Interface 
•Objects Are a More Natural Approach: 
Phyla creates real world databases 

• Drag-and-Drop Ease; Relate objects by simply dragging objects 
between windows 

• Create Custom Forms and Reports; Quickly create custom forms 
and reports 

• Fast Rnds and Sorts: Perform complex queries and calculations 
without programming 

• Synchronize Multiple Databases Copies 

• Password Protection With /Access Limitations 

• Easy Import and Export; Import from other databases, export data 
in various formats 

(SPHYLA) Our Price $179 


BBEdit 4.0.4 

by Bare Bones Software 

A powerful, easy-to-learn text 
editor. Adds new features for 
HTML coders, including a 
spelling checker and HTML tag 
palette. /Accelerated for Power 
Macintosh: dragging supported everywhere: Internet Config 
aware; PowerTalk aware. Integrated support for Symantec's 
IDE. Metrowerks CodeWarrior, THINK Reference 2.x. MPW 
ToolServer, and most other environments. Many UNIX style 
tools, including "grep" arches, file comparisons, and sorting 
multi-file search and replace. PopUpFuncs feature lets you 
jump to a function from a menu. 

(SBBEOIT) Our Price $119 
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CPU Doubler 

by Orchard Software 

• Performance enhancement utility 
for the Macintosh 

■ Increases the speed of your 
computer by 100% 

• Works on both the PowerPC and 
68K Macintosh 

• Manages computer throughput 
using a proprietary scheduling 
algorithm 

• Ensure optimal performance and 
compatibility 

(SCPU2X) Our Price $79 
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EtherPeek 

by AG Group, Inc, 

EtherPeek for Macintosh is a full-featured 
protocol analyzer that allows you to quickly 
and easily test and debug network communication, and; 

• Check for protocol compliance 

• Lise hundreds of buitt-in decodes 

• Develop custom packet decoders 

• Filter packets during or after capture 

• Test device reactions to specific packet types 

• Customize or alter packets for transmission 

• Generate traffic to test varying loads 
(SEPEEK) Our Price $745 




Compilelt! 

by Royal Software, Inc. 

Compilelt!, the first HyperTalk compiler, is a complete developement 
system for the creation of XCMDs and XFCNs, 

• Expand the capabilities of your environment by using Compilelt! 
and the RCM Toolbox extensions 

• Increase the speed of routines written in HyperTalk by turning 
scripts into externals 

• Protect sensatlve code from prying eyes because your code is 
now compiled! 

• Easily learn Macintosh programming by exploring the RCM 
Toolbox 

• Includes Debuglti, a valuable source-level debugger for externals 
created with Compilelt! 

(SCOMPIT) OurPrice$149 


DesignWorks 4.0 

by Captlano Computing 

DesignWorks 4.0 has all the ease 
of use and schematic editing 
power of previous versions, plus 
new features designed to make 
your entire design process easier 
and more error free. The 4,0 
version has new menu customization and scripting features friat will 
directly address your design checking and interfacing needs. 

• Flexible schematic editing features speed the drawing process 

• Full Undo/Redo on all editing operations 

• Hierarchical design with unlimited levels is fully supported 

• Powerful attribute features allow arbitrary text information to be 
associated with any signal, device or device pin 

• Extensive symbol libraries with over 12,000 parts in ANSI and 
IEEE format 

• Integrated device symbol editor allows you to create custom 
symbols using standard drawing tools 

• Interactive digital simulator option is available. No netlists, no 
application switching! 

(SDWORKS) Our Price $995 




OpenGL for 
the Macintosh 

by Conix Graphics 



OpenGL is the premier 3D graphics library that allows software 
developers the ability to develop high-quality, interactive 2D and 3D 
graphics applications. OpenGL can perform the following wide range of 
functions which will enhance the development of all graphics software: 

• Geometric primitives (points, lines, and polygons) 

• RGBA or color index mode 

• Viewing and modeling transformations 

• Texture Mapping, Lighting, Shading and Z Buffering 

• Atmospheric Effects (fog, smoke, and haze) 

• Alpha Blending (transparency) 

• Antialiasing, Accumulation Buffer, Stencil Planes 

• Display list or immediate mode 

• Polynomial Evaluators (to support Non-uniform rational B-splines) 

• Feedback, Selection, and Picking Raster primitives (bitmaps and 
pixel rectangles) 

• Pixel Operations (storing, transforming, mapping, zooming) 
(SOPENGL) Our Price $389 


VText 

by Vivistar 

VText is a C-t-i- add-on library for 
Metrowerks' PowerPlant application 
framework. VText provides complete 
Macintosh text support including: greater 
than 32kb text, undo, drag and drop editing, 
AppleEvent scripting and recordability, full 
support for multibyte characters and inline 
input methods including Japanese and Chinese text, and full support 
for bi-directional script systems including Arabic and Hebrew. 

• Full featured text engine for Metrowerks' PowerPlant 

• Stylesets and rulersets with tabs 

• Flexible object oriented C++ API 

• Full undo and drag and drop editing 

• WorldScript savvy including bidirectional and multibyte scripts with 
inline editing 

• AppleEvent factored for scriptability and recordability 
(SVTEXT) Our Price $349 
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QUED/M 3.0 

by Nisus Software 

• The programmer's text editor that defined the 
industry standard for speed and efficiency 

• PowerPC native 

• Features integrated support for Symantec 
C/C++, Metrowerks CodeWarrior 6, and MPW 

• Supports all the major development environments on the Macintosh. 

• Powerful editing features, including unlimited undo and redo, macro 
language, scripting, text folding, ten editable/appendable clipboards, 
markets, displaying text as ASCII codes, dynamic coloring of C/C++ 
keywords/comments, rectangular and non contiguous selection 

• Includes Celestin Company’s APPREtfllCE 4 
(SQUEDM) Our Price ^9 


AG Author 

by Lakewood Software 

AG Author 1.0 is a full-featured /\ppte Guide authoring tool with 
fully customizable project template. The following features are 
unique to AG Author: 

• Support for styled, colored, & hot text 

• Fully customizable project template 

• Flexible compile options 

• Find & replace tool for scripts 

• Multiple open projects 

• Rapid deployment of project globals 
(SAGA) Our Price $99 

SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman's 
AppIcGulde Starter Kit, Real World AppleGuide 




Bee-one 

by Power Box 

Bee-one lightens your load on the road by 
adapting relational databases developed 
under 4D“ to the Newton Platform. Once 
the program is installed on both the 
Macintosti and the Newton, it takes 4 
simple steps to use Bee-one! 

• Database transfer, Set-up. Use, and Synchronization 
(SBFEONE) 0urPrice$139 


Web Ware 

by BeachWare, Inc. 

The ultimate collection of dip media and templates 
for building your own Web Page. An incredible 
selection of Shockwave movies, animated GIFs, 
buttons, bullets, dividers, and sample HTML pages. 
There are literally thousands of graphical elements on this disc, all there 
to spice up your web page. In all. it's about 300 megabytes of creativity 
only a mouse-click away! System Requirements; PC - 486 or better with 
8 MB RAM, Sound card, SuperVGA, CD-ROM drive. Macintosh - Color 
Mac with 8 MB RAM. (D-ROM drive. 





(SWEBW) Our Price $24 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

Fortran 77 SDK 

SF77 

589.00 

ICONIX PowerTools-10 Pack 

SICPP10 

7,845.00 

ICONIX PowerTools-6 Pack 

SICPP6 

5,945.00 

ICONIX PowerTools-8 Pack 

SICPP8 

6,945.00 

ICONIX PowerTools-AdaFlow 

SICADA 

1,395.00 

ICONIX PowerTools-ASCII Bridge 

SICASCII 

1,395.00 

ICONIX PowerTools-CoCoPro 

SICCOCO 

1,395.00 

ICONIX PowerTools-DataModeler 

SICDATAMOD 

1,395.00 

ICONIX PowerTools-FastTask 

SiCFASHASK 

1,395.00 

ICONIX PowerTools-FreeFlow 

SICFREEFL 

1,395.00 

ICONIX PowerTools-Object Modeler 

SICOBJMOD 

1,395.00 

ICONIX PowerTools-PowerPDL 

SICPOWER 

1,395.00 

ICONIX PowerTools-QuickCiiart 

SICQUICKCH 

1,395.00 

ICONIX PowerTools-SmartChart 

SICSMART 

1,395.00 

ICONIX Training & Consulting 

TICONIX 

2,945.00 

IMSL Math and stat Library 

SIMSLSTAT 

495.00 

Info-Mac X 

SINF0MAC10 

39.95 

Ionizer Real-Time Spectral Reshaping Tool 

StONIZER 

800.00 

LiveAccess^” 1 User Edition 

SLAUE 

69.00 

LiveAccess™ 1 Developer Edition 

SLADE 

99.00 

LlveCard 

SLCARD 

149.00 

U Profiler 

SUPROF 

295.00 

Macnow": Flowchart Design and Development 

SMACFLO 

179.00 

Mac Source II 

SMACSOURCE 

29.95 

Nisus Writer 5.0 

SNISUSW 

220.00 

Plan & Track*^"* Product Planning and Management SPLNTRK 

179.00 

Screen Machine 

SSM 

24.00 

Spyer 

SSPY 

39.00 

Visual Cate 

SVCAFEMAC 

199.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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WebTen 

by Tenon 
Intersystems 

WebTen is an 
industrial-strength, 
tiigli-performance 
Apache Web server for 
Power Macs. WebTen’s 
Web-based browser 
interface enables iocal 
or remote administration via your favorite browser. Since Appie’s NeXT 
acquistion, Tenon has extended their unique “UNiX virtuai machine" 
technoiogy to produce a set of "Rhapsody-Ready” internet 
appiications. WebTen is the first offering in this series. 

• WebTen is the fastest Web server on Power Macintosh 

• Sustains up to 10,000 connections a minute, or over 10 million 
connections a day 

• Apache runs in Tenon’s muiti-threaded, pre-emptive 
multitasking environment 

• Tenon's unique technology supports the widely acclaimed Apache 
Web server as a doubie-clickabie Macintosh application 
(SWEETEN) Our Price $495 


OOFILE Reporter Writer 

by A.D. Software 

• Full embedded report-writer, allows you to preview page-by-page 
and either print or save as plain text, HTML or RTT^ 

• Multiple levels of breaks, database views, headers and footers are 
provided using a clean obiect-oriented design 

• incudes RAM-based version of OOFILE database. Included in full 
OOFILE Platform Bundle 

• Saving to file without preview of printing is cross-platform-njn on 
your MacAiVin/Linix server and creates 

web pages 

• Price includes 1 -year subscription 
(SOORW) Our Price $499 


WebSiphon 

by Purity Software, Inc. 

WebSiphon is one of the most 
anticipated new CGi products for 
Macinlosh Webmasters delivering a 
complete authoring tool for truly 
revolutionary sites. This product 
alone can replace most all CGIs on 
your site resulting in increased dynamic serving speed, 
reliability, and powerful scripting and dat^ase abilities directly 
within your HTML pages! Also includes Verona, the fastest flat- 
file database server available for Macintosh web sites. 
(SWSIPHON) Our Price $495 





PageChai'tner: Sizzling Effects... 


PageCharmer 1.0 

by Mainstay 

PageCharmer is a set of customizable interactive applets that 
enhance web pages without writing a single line of HTML code. 
Whether the web site is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need. 

FEATURES; 

LiveG-Map, LiveT-Map, LiveG-Button, LiveT-Sutton, LiveGT-Button, 
LiveG-Ticker, LiveT-Ticker, LiveG-Marquee, and LiveT-Marquee. 
(SPGCHRM) Our Price $139 


BBEdit 4.0.4 

by Bare Bones 
Software 

A powerful, easy-to- 
learn text editor. Adds 
new features for HTML 
coders, including a 
spelling checker and 
HTML tag palette. 
Accelerated for Power Macintosh; dragging supported 
everywhere; Internet Config aware; PowerTalk aware. 
Integrated support for Symantec’s IDE, Metrowerks 
CodeWarrior, THINK Reference 2,x, MPW ToolServer, and most 
other environments. Many UNIX style tools, including “grep" 
searches, fiie comparisons, and sorting multi-file search and 
replace, PopUpFuncs feature lets you jump to a function from 
a menu. 

(SBBEDIT) Our Price $119 



ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C-i-r classes for integrating 
Internet e-mail in your applications 

• Helps you write software that can share 
mail with oflier leading e-mail products 

• Royalty-free MIME, SMTP, and POPS W^ls 
for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 
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Roaster 

by Roaster Technologies, Inc. 

Roaster Release 31$ now available and shipping! Get the most out ot 

Sun’s programming ianguage with this powerful 

development environment. 

• Features include; ability to build completely stand-alone Macintosh 
applications or applets; visual interface builder; ability to create 
cross-platlorm zip files; powerful Java debugger; wizard for quickly 
creating Java applets or applications; JDBC Included; Java object 
database included; ability to call AppleScripts from Java; Just-in- 
lime (JIT) compiler; JDK 1.0.2 support; class tree and hierarchical 
class browser; much more! 

• Software includes: Over 300 example applets and applications; 
Netscape Internet Foundation Classes; Object Design’s PSE for 
Java; OpenLink Software's JDBC Drivers; OpenSpace Java Generic 
Library; Microline Component Toolkit Lite 3.0; much more! 

• Requirements: Runs on 68k or PowerPC, CD-ROM 

• Price includes all web-based updates 
(SR0AST3) Our Price $49 
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Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the only Macintosh product that can turn your 

Macintosh into a complete Unix workstation. Based on 

BSD4.4 and the Mach kernel, MachTen brings the power 

of Unix to your desktop at an extremely attractive price point. 

MachTen enables you to: 

• Run a high speed internet server, complete with WWW, RP, NFS, 
DNS and print service 

• Build a Mutihomed Web Server 

• Develop applications in a Unix development environment, replete 
with the acclaimed GNU development toolset 

• Program in Ada, C, C-t-+, Pascal. Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, already ported for MachTen 
and available on our Ported Applications CD-ROM 

• Run Software.com Inc’s acclaimed Post.Office rrsill transport service 
(SM10PPC) Our Price $695 


ScriptDemon 

by Royal Software, Inc. 

ScriptDemon is a browser plug-in that, for the first lime, allows you to 
deliver and run AppleScripts from Web pages. The ScriptDemon plug¬ 
in will execute the embedded AppleScript code included on a Web 
page. ScriptDemon painlessly and inexpensively handles many 
previously impossible tasks, such as: 

• Using the Intranet to manage all Macintosh computers on-line 

• Using the Internet to install and configure software 

• Using the Internet to configure hardware 

• Delivering complex sets of files and assembling them on the 
browsing computer 

• Providing interactive education and product support on both the 
Internet and Intranet 

• A perfect companion to UveCard! 

(SSDEMON) Our Price $949 



CGi Toolkit 

by Pictorius Inc. 

The Pictorius CGi Toolkit is the fast and 
easy route to high performance CGIs 
and ACGIs for your Mac Web site. 

•Interactively develop CGIs while the 
web server, the CGI Toolkit and the browser are running on the 
same machine 

• Interactively develop, test and debug CGIs before compiling 

• Powerful debugger allows you to edit code, roll back, code and 
change input values while your application is running 

• Fully object oriented so you can re-use your code 

• Automatic handling of Apple Events so you can concentrate on 
building functionality 

• Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 

(SCGITLKT) Our Price $149 


Web Ware 

by BeachWare, Inc. 

The ultimate collection of clip media and 
templates for building your own Web Page. 
An incredible selection of Shockwave 
movies, animated GIFs, buttons, bullets, 
dividers, and sample HTML pages. There 
are literally thousands of graphical elements on this disc, all there to 
spice up your web page. In all, it's about 300 megabytes of 
creativity only a mouse-click away! System Requirements: PC - 486 
or better with 8 MB RAM. Sound card, SuperVGA, CD-ROM drive. 
Macintosh - Color Mac with 8 MB RAM. CD-ROM drive. 

(SWEBW) Our Price $24 
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FaceSpan v2.1 

by Digital Technology International 

• Develop integrated software, make stand 
alone applications, create friendly 
interfaces 

• Develop quick prototypes, print multiple 
pages with sophisticated layouts 

•Script essential elements of the FaceSpan 
application - Enhanced save options 


• Play and record sounds as either "snd’’ resources or as “AIFF" files 

• Create miniature or compiete apps that run on either Power PC or 
68k computers 

• Use precise time measurement for impiementing timed behaviors 
— New properties 

• Proportionally scale PICT images -Align images in a pictbox - 
Automate any ^plication 

• Monitor and respond to low-memory situations-Increased support 
for Frontier UserTalk! 

(SFACESPAN) Our Price $299 


PreFab Player 

by PreFab Software, Inc. 

PreFab Player is a faceless background application (similar to a 
system extension) that lets your scripts query and control otherwise 
non-scriptabie applications, desk accessories and control panels. 
Player adds verbs that directly manipulate the Macintosh user 
Interface: choose from menus & pop-ups, select radio buttons, type 
text, determine the name of the frontmost window, the state of a 
check box, etc. Balloon help identifies non-standard dialog items. 

• Adds verbs to AppleScript and to Frontiers UserTalk 

• Controls the Frontmost Application 

• Balloons Identify User Interface Objects 
(SPLAYER) Our Price $95 


Scripter 2.0 

by Main Event Software 

For professionals, for novices, for 
webmasters, for solutions providers, there’s 
only one serious choice. Scripterl 
• Scripter and FaceSpan work together: one 
click opens your FaceSpan script in 
Scripter, another sends ft back 

• Debug handlers without modifying your scripts using the Call Box 

• Applet simulation, live editing, Object map, associated terminology 

• Search backwards, block generators, more navigation shortcuts, 
more drad-and-drop, and an even more enhanced trace log 

• Now Includes ScrfptBase; stores your data and media elements 
and share them between scripts all with a special new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable application 

• Scripter is the natural companion to AppleScript for users at all 
levels of proficiency. Don’t write scripts without it! 

(SSCRIPTER) Our Price $199 



AppleScript Software 
Development Toolkit 1.1 

by Apple Computer, Inc. 

• AppleScript language, system software 
extension, and script editor 

• FaceSpan 1.0 

• Developer’s redistribution license for 
AppleScript System software extension 
and FaceSpan runtime code 
(SASDT) Our Price $49 


Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphical view of objects provided 
applications 

• Includes Late Night Software Scripting Additions - a collection of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDEBUG) Our Price $129 



by scriptable 



TCP/IP Scripting Addition 

by Mango Tree Software 

•Award-winning AppleScript scripting 
addition 

• Allows you to write scripts using 
MacTCP^i^ commands in AppleScript™ 

• Send e-mail or files through a script, 
check if users are logged on (via Finger), automate FTP, Gopher, 
NetNews, Telnet, and LPR, verify links in HTML documents, and 
quickly write many other TCP/IP client-server programs 

• Works with AppleScript, MacTCP 2.0.4 and Open Transport 
(STCP) Our Price $49 


WindowScript 

by Royal Software, Inc. 

WindowScript is the ultimate tool for designing Macintosh user 
interfaces using FfyperCard. Design Real "Macintosh" user- 
interfaces right inside HyperCard. Until now you either created 
HyperCard stacks or Macintosh applications. With WindowScript 
you can literally bring the look and feel of a real Macintosh user- 
interface to HyperCard. If you’re a HyperCard developer, interface 
designer, application developer, program manager or tester 
searching for a prototyping too!, WindowScript is perfect for the Job, 
^WSCRIPT) Our Price $149 
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Apple Media Tool Programming Environment 2.1 Multimedia Authoring with Apple Media Tool 

by ^ple Computer, Inc. by Apple Computer, Inc. 


This object-oriented language and application frameworit altovus 
programmers to customize features used within the Apple Media 
Tool authoring environment 

Includes an expanded Apple Media Language (AML) class library, 
incremental compiling and linking ot AML code, taster debugging 
facilities, Macintosh Programmers' Workshop (MPW). and user-oriented 
documentation written from an AMTPE developer's perspective 
Portable across 68K, Power Macintosh, and Windows platforms 


Apple Media Tool offers new multimedia users a way to get started 
creating interactive multimedia with minimal learning time. This self- 
paced tutorial will make Apple Media Toot (AMT) even easier to 
understand and to use. Using this tutorial, you will create a realistic 
multimedia project using exciting techniques such as QuickTime 
movies, animation and more. A demo version of AMT is included and 
can be used for the exercises. Training Format; Tutorial with labs. 
(SMWAMT) Our Price $49.95 



(SAMTPE) Our Price $995 



Virtual Reality 

Programming 

with QuickTime VR 2.0 


by Apple Computer. Inc. 

• Virtual Reality Programming Book/CD-ROM 
for QuickTime VR 2.0 

• Enables you to write C and C+-i- programs 
using QuickTime VR 2.0 

• Allows QuickTime VR to be used in 
games, multimedia titles and other 
programs 

• QuickTime VR 2.0 objects can be zoomed 
in on, panned, or linked with hots spots 

• Both panoramas and objects have hot 
spots linked to World Wide Web URLs 
(SVRPQT) Our Price $49 



QuickTime Developer’s Kit 2.0 

by Apple Computer, Inc. 

• QuickTime 2.0 Extension, QuickTime Power 
Macintosh Extension, and QuickTime 
Musical Instruments extension 

• Uhtities like MoviePlayer 2.0,16-bit Audio 
Compression, etc. 

• Sample content such as MPEG Movies, 
Music Movies, Time-Code Movies, and 60 
field per second movies 

• Includes sofiware-only playback features 
such as faster 2x playback mode for 
current compressors. Apple Cinepak 
compressor, l-bit fast dithering, network 
tuning. load-into-RAM option, and Photo 
CD support 

(SQTDK) Our Price $99 


ClipVR"* 

by eVox Productions 

Clip VR'" is a new digital image library 
offering high quality Photographic Virtual 
Reality (PVR) images for use with Quicktime* 
VR and other desktop VR tools. 

Clip VR " Panoramic Image components include 
alpha channel masks. Combine elements into a 
composite panorama which is converted to ^e 
finished QuickTime VR movie using Make QTVR 
Panorama Tool. The Components ("Clips”) 
include complete 360 degree scenes, 
libraries of 360 degree terrains, 360 degree 
skies, buildings, and objects. Images are 
provided as .PICT files AND QuickTime VR 
movie files. Clip VR^“ allows you to create 
high quality VR worlds from pre¬ 
photographed component images. Clip VR™ 
can be used to add excitement to a web site, 
to increase the Interactive value of a CD- 
ROM, or simply for fun! Requires imaging 
editing program such as Adobe Photoshop'” 
to perform .PICT image compositing. 
(SCLIPVR) Our Price $89.95 


QuickTime VR 2.0 
Authoring Toois Suite 

by Apple Computer, Inc. 

• QuickTime VR is a cross-platform software 
from Apple which enables webpage 
designers and professional developers to 
create new multimedia products and 
webpages Incorporating QuickTime VR 
content. With QuickTime VR, users 
interactively navigate through 360° views 
of space, and explore three dimensional 
objects on Macintosh or Windows-based 
personal computers 

• The QuickTime VR Authoring Tools Suite is 
a set of Macintosh tools to create and link 
panoramas and objects from 


photographic, digital, video, or computer 
generated images 

• Included is a complete set of 
documentation for planning, designing, 
photographing, and creating QuickTime VR 
panoramas and objects. The authoring 
tools also allow you to link objects to 
panoramas using clickable hot spots 

Included on the CDs are; 

• A software tool (MPW-based) that stitches 
and blends adjacent images into a 
panoramic PICT file 

• A software too! (MPW-based) that dices 
and compresses panoramic PICT files to 
less than 100 KB (low resolution) per 
panorama 


• A scene editor (HyperCard-based) to 
create QuickTime VR scenes by adding 
and positioning nodes, hot spots, linking 
nodes together, and tor linking QuickTime 
VR objects to scenes 

• A variety of utility toois for formatting the 
data into the runtime software 

Due to a revolutionary distortion-correcting 
algorithm, QuickTime VR panoramas and 
objects maintain a normal perspective when 
the user moves the mouse. The speed of the 
algorithm allows up to 24-bit color images. 
Both vertical and horizontal panning can 
oaur at fast speeds. 

(SQTVRATS) Our Price $395 
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Teiran Interactive 


Media Cleaner Pro 

by Terran Interactive 


aw' ^ o UCf! 
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Use Media Cleaner Pro 2.0 to optimize and compress video for 
CD-ROM, kiosk, or the Internet. Media Cleaner Pro automates 
your work flow allowing you to get the highest quality video, 
faster and easier than any other program on the market. 

• Includes Adobe Premiere Export module 

• Optimal palette generation, Drag-and-drop batch processing 

• RealMedia, TOOLive and improved QuickTime support 

• Dynamic Preview Window, the Media Wizard, multiprocessor 
support and more! 


Captivate 4.6: 

Essential Gfaphics Utilities 

by Mainstay 

Captivate'*^ 4.6 is a powerful collection of 
graphics utilities for Macintosh, based on 
Mainstay’s acclaimed screen capture utility, 
graphics and multimedia scrapbook, and 
graphics viewer. Captivate provides essential graphics utilities to the 
professional and hobbyist alike. 

■ Package includes; Captivate Select, Captivate View, and Captivate Store 

• Any one of the three can be used alone, and together they make 
an unbeatable team 

• Whether writing a training manual, creating an ad. or just creating 
a startup screen from your favorite picture, Captivate is everything 
professionals need at a price anyone can afford. 

(SCAPTIV) OurPnce $79 



System Requirements: 

68040 Mac or better (PowerPC strongly recommended, req'd for 
RealMedia), QuickTime 2.0 or later (2,5 strongly recommended) 

8 Mb application RAM. MacOS 7.0.t (7.5 or later recommended) 
SoundManager 3.2. CD-ROM Drive 
(SMCP) 0urPrice$359 

Registered owners of Movie Cleaner Pro 1.3 or earlier can upgrade 
(SMCPUP) Qur Price $129 


\ 

O' 


/„ 4 ' 

purchd^T X 




Music Tracks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music CD-ROM. The dips include 
musical introductions, fanfares, background music, and more. This 
collection offers you 100 music clips stored in .WAV fomiat tor 
Windows, SoundEdit & AIF formats for Macintosh and as Audio 
tracks for audio CS players. All of the music clips are completely 
license and royalty-free!! Mac System requirements: Mac Plus or greater, CD-ROM drive. PC 
system requirements: Windows 3.1 or later, Sound Blaster compatible board. CD-ROM drive. 

(SMT) Our Price $24 

Order Toll-free 
a00-MA€DEV-1 

IBOOd22-338Il 

MultiWare 

Multimedia Collection 

by BeachWare, Inc. 

Introducing a new Audio multimedia music CD-ROM for the 
Macintosh. This disc is a collection of clips ideal for Oesidop 
Presentations and other Multimedia applications. This incredible 
collection of license-free media clips is bursting with 240 + color pictures and backdrops PCT), 
200-1- sound & music clips ^undEdit), 140-i- QuickTime movies, and a variety of multimedia 
tools for use with the Macintosh. 

(SMWMC) Our Price $24 







Audlolk'ack 

by WAVES 

AudioTrack is a 
software plug-in lor 
native processing on 
digital audio 
recording and editing 
systems. Waves 
AudioTrack combines the most-needed audio 
processors into a single piece of software, 
including 4 bands of equalization, 
compression/expansion, and noise gating. 
AudioTrack is ideal for preparing audio for 
InterNet streaming formats, processing 
individual mono/stereo tracks of audio and 
audio for video editing systems including 
digital sequencers. 


Feature list 

• A single window interface 

• 4-band ParaGraphic Equalizer, 
Compressor/Expander and Gale 

• Instantaneous A/B comparisons of on-line 
settings 

• Pretested setup libraries supplied for 
various processing solutions 

• Power Macintosh native processing 
(requiring no DSP board) 

• Volume and gain reduction meters 

• Peak hold and clip meters 

Requirements: 

The AudioTrack is compatible with all 

machines supported by Deck li, SoundEdit 16, 

Adobe Premiere 4,0 and Cubase VST 3.1 

(SAUDIOTRK) Our Price $270 
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Casino! 

by BeachWare, Inc. 

Can’t make it to Vegas this month? Your 
best bet is Casino! Whether your favorite is 
Slots, Poker, Blackjack, or Keno, this virtual 
casino will entertain you for hours with its 
ten different machines, Mac System 
requirements: Color Mac, CD-ROM drive, 4 MB of RAM. PC system 
requirements: Windows 3,1 or later, CD-ROM drive, 4 MB of RAM, 
(SCAS) Our Price $24 



Abuse 

by Bungle Software 

Abuse is 360 degrees of side-scmlling actbn. 

Run, jump, fall and fly in any directioi - ttirough 
industrial corridors, caverns and sewers. Destroy 
enemies in any direction with grenade launchers, 
rocket launchers, napalm and nova spheres! Avoid 
deadly traps with jet packs and turbo txMst! 

Key Features: 

• Make your own mayhem with the Level Editor 

• Hunt down your friends in 8-person multiplayer games 

• Awesome Arsenal, Napalm Bombs, Nova Spheres and the Deafri Saber: 
just a few ways to lay waste! 

• Point and Kill Interface, Move and annihilate mutants in complete 360° freedom 

• Blast your way through floors, walls and ceilings in search of the ultimate 
power-up! 

• Abuse is 360 degrees of side-scrolling action. Run, jump, fall and fly in 
any direction - ttirough industrial corridors, caverns and sewers 

• Destroy enemies in any direction with grenade launchers, rocket 
launchers, napalm and nova spheres! Avoid deadly traps with jet packs 
and turbo tMost! 

(SABUSE) Our Price $51 



1000 Games for 
Macintosh 

by BeachWare, Inc. 

The best Macintosh game disc in the 
entire world, this CD-ROM contains over 
one thousand great shareware and public domain programs. Battle ugly 
aliens, blast apart mn-away asteroids, deal yourself ttiat royal flush or 
solve that 3-D puzzle, this disc has it all! System requirements: Mac 
Plus or greater, CD-ROM drive, and 2 MB of available RAM (4 MB of 
RAM when mnning under System 7}. 

(STGM) Our Price $17 



Classic Arcade 

by BeachWare, Inc. 

Ten of your tavohte coin-arcade games, 
redone with killer graphics and sounds! Walk 
through a virtual arcade and test your game 
playing skills with these exciting arcade 
classics, Ten g^es, including Moon Lander, 
Astro-Boing, Hyper Hockey, Ballistic Avenger, and more. System 
Requirements: Mac - Color Mac with 8 MB RAM, CD-ROM drive. PC 
486 witii 8 MB RAM, Sound card, SuperVGA, CD-ROM drive, 

(SOLA) Our Price $29 

Marathon IHiogy Box Set 

by Bungle Software 

The Marathon Trilogy Box Set brings all three 
Marathon games together in one affordable package, 
with tons of extras thrown in. Besides Marathon, 
Marathon 2: Durandal and Marathon Infinity, you'll 
also receive a staggering 1200 maps, featuring 
never-released Bungie maps and the winners of the 
infinity Mapmaking Contest, The Marathon Scrapbook 
(a behind-the-scenes look at themaking of the Marathon games), Marathon 
collectablefi like the Marathon 3-sticker set, and to top it off, the award¬ 
winning game that laid the groundwork for Marathon: Bungle's breakthrough 
Pathways Into Darkness. 

The Marathon Trilogy Box Set is native to the Power Macintosh, utilizes the 
graphics acceleration of 630 and 6200 machines, is 8,16 and 24-bit color 
capable, and can be played with joysticks and game pads, The package 
requires a 68040 or higher Macirttosh,CD-ROM drive, 8-bit color monitor 
(13" recommended), and System 7 or later. 

(SMTBS) Our Price $65 








Tirivia Warehouse 2000 

by BeachWare, Inc. 

Introducing a fun new PC and Mac CD- 
ROM. This disc contains two thousand 
trivia questions, in 45 categories. In 
several game formats! Test your memory 
with the Q&A, Concentration, and Multiple 
Choice games! Categories include: 
Animals, Bodies, Bond, Bugs, Cities, Comics, Geography, Gilligan, 
Gross, Health, Holidays, Horrors, Kids, Knot's Landing, Math, Movies, 
and many more. Mac S^tem requirements; Color Mac, CD-ROM 
drive, 4 MB of RAM. PC system requirements; Windows 3.1 or later, 
CD-ROM drive, 4 MB of RAM. 

(STW2K) Our Price $24 



Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

3D Game Machine 

S3DGAME 

$299.00 

A Zillion Sounds 

SAZS 

24.00 

Night Sky Interactive 

SNSI 

24.00 

Vitamin 

SViTAMIN 

24.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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System 7.5 Technologies 

by Apple Computer, Inc. 

• Self-paced course designed to allow 
software developers to write code that 
extends the functionality of an application 
for System 7.5 

• Contains comprehensive materials for drag-and-drop, threads, 
standard mail package, and QuickDraw GX printing 

Students should be familiar with the basics of developing an 
application on the Macintosh. Metrowerks CodeWarrior Lite is 
included on tfie CD with the lab exercises. The lab assignments were 
developed in CodeWarrior 8. The labs can also be done in another 
development environment but project files for them are not provided. 

Training Format; Tutorial with labs. 

Requirements: Macintosh or Mac-OS compatible computer with a 
68020 processor or greater (PowerPC preferred); 8 MB RAM; 25 
MB hard disk space; System 7.5 or iater; CD-ROM drive. 


Apple Guide Integration 

by Apple Computer, Inc. 

• Self-paced overview teaches you when and 
how to add Apple Guide help to your program. 

• Powerful help system that can guide the 
user through a task. 

• Tutorial will lead you through the steps necessary to integrate 
Apple Guide into your application. CodeWarrior Lite is included on 
the CD wito the lab exercises. 

Training Format: Overview with labs. 

Requirements; Macintosh or Mac-OS compatible computer with 
68020 processor or greater, PowerPC preferred; 8 MB RAM; 25 MB 
hard disk; System 7.5 or later; CD ROM drive. 

(SAGI) Our Price $49.95 




(SSYSTECH) Our Price $49.95 


Virtual Ibtor for QuickTime VR 




by Apple Computer, Inc. 

• Self-paced, hands-on course, which 
provides a comprehensive environment for 
learning the steps of the QTVR 
development process. The student can 
cover all of the topics or choose areas to 
focus on. Topics covered include: QTVR 
capabilities and key concepts, panoramic 
movies, object movies, QTVR Scene 
movies and authoring with QTVR 

• CD-ROM contains lots of useful examples 
and demos, In addition to all the step-by- 
step exercise files 


If the student completes the entire course, 
he/she will create a complete, authored 
multimedia project similar to the 
demonstration title that comes on frie 
enclosed CD-ROM. There are approximately 
3-4 days of training. 

Training Format; Tutoriai with labs. 

Requirements; 40 MB RAM minimum, 64 
MB preferred; Macintosh or Mac OS- 
compatible computer with a 33 MHz 68040 
processoror greater; System 7,1 or later; 
CD-ROM drive; 17" color monitor. 
(SVTFQTVR) Our Price $79.95 



Apple’s develop™ 
back issues are 
available for only 
$10 per copy. 

To place your 
orders, call 

800/MACDEV-1. 



ftf XUTimkfiJt 
f'nojrflPiHfDf #• UcTfifn/Mn 

MAGAZINE 

MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with 
everything they need to know about software development. Topics 
like Rhapsody, Java, QuickTime, OPENSTEP, Qbjective-C, C/C-t-t-, 
Object Oriented Technologies, product reviews and much more! 
Subscriptions: 

(MTYRDM) LIS/Domestic $47 for 12 issues 

(MTYRCM) Canadian $59 for 12 issues 

(MTYRFM) International $97 for 12 issues 

Back Issues: $10 each plus shipping (subject to availability) 
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CodeWarrior Wear 

You live it, you breath it... you 
might as well wear it! (XL only) 



Mien T-Shirt 

(A/^EN) Our Price $9.95 
Arnold T-Shirt 

(ACWARNLD) Our Price $9.95 

Arnold Jr. T-Shirt 

(AARNOLDJR) Our Price $9.95 

Blood, Sweat & Code T-Shirt (SS) 

(ACWSBLOOD) Our Price $9.95 

Blood, Sweat & Code T-Shirt (LS) 

(ACWLBLOOO) Our Price $14.95 

CodeWarrior Baseball Cap - Black 

{ACWBHAD Our Price $14.95 

CodeWarrior Baseball Cap - White 

(ACWWHAT) Our Price $14.95 

CodeWarrior Sweatshirt - Black 

(ACWSWEAT) Our Price $29.95 

CodeWarrior Hawaii Five-0 Shirt 

(ACWHAWAll) Our Price $9.95 

CodeWarrior Winter Hat 

(AWINHAT) Our Price $14.95 

Debugger Boxer Shorts 

(/y^BOXER) Our Price $16.95 

Discover Programming T-Shirt 

(ADISCPT) Our Price $9.95 



Legtop Podeum 

by Rach Inc. 

A combination worlong 
platfomi and carrying case 
that allows laptop owners a 
safe and comfortable way 
to use their computer in a variety 
of mobile and field environments. 
• Straps to your leg for mobility! 
(ALGTPPOD) Our Price $79 



MacTech® Mouse Pad 

Slide on this! With an extra-large surface (11" by 10") and 
a deluxe sleek plastic coating, you'll be zooming across 
your screen in no time at all. Speed limit not enforced! 

(AMTPAD) Our Price $8.95 
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Getting Started With WebObjects 

by NeXT Software, Inc. 

tl you're a first time user, start here to learn the basics of how to 
create and run WebObjects applications, 

(BGSWO) Our Price $14 

WebObjects Developer's Guide 

by NeXT Software, inc. 

A guide to building and understanding WebObjects appiications. 
Takes a close look at the W^Objects scripting language. Additional 
sections explain Ihe WebObjects architecture and tells you how to 
integrate your code into the request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Filled with 
example code. For all WebObjects programmers. 

(BWODG) Our Price $16 

D'OLE Developer’s Guide 

by NeXT Software, Inc. 

Distributed OLE is available today, and this book shows you how to 
use it. Using real-world examples, the book steps you through the 
process of making your OpenStep objects available on Windows 
through OLE. 

(BDOLEOG) Our Price $22 

Discovering OPENSTEP, Mac 

by NeXT Software, Inc. 

Introduces programmers to NeXT's OPENSTEP 4.0 Developer product 
by guiding them through the creation of three applications of 
increasing complexity. The tutorials demonstrate and explain 
programming techniques, Objective-C fundamentals, common APIs, 
and usage of the developement tools. Along the way they present 
summaries of important concepts and paradigms. The book also 
itidudes a chapter directing readers to programming resources, 
further information, and services such as training and support. An 
appendix offers a concise discussion ol object-oriented programming. 
(BDOSTEPM) Our Price $15 

Discovering OPENSTEP, Windows 

by NeXT Software, Inc. 

Discovering OPENSTEP provides an introduction to OPENSTEP 
programming on Windows NT. It guides the reader through the 
creation of three applicatons of increasing complexity. Along the way, 
It explains concepts and Illustrates aspects of ObjecOve-C, OpenStep 
classes, the development environment, and programming techniques. 
A short appendix offers a summary of object-oriented programming. 
(BDOSTEPW) 0urPrice$16 



Object-Oriented 
Programming and Objective C 


by NeXT Software, Inc. 

An introduction to the principles of object-oriented programming in 
OPENSTEP and the official description of the Objective-C language. 
Objective-C is easy to learn and use because it adds very little 
syntax to the C programming language. It's dynamic nature allows 
you to accomplish things not possible in most other object-oriented 
languages. For any OPENSTEP programmer, 

(BOOPOC) Our Price $24 

Working w/ Interface Buiider (for eof) 

by NeXT Software, Inc. 

A hands-on, award-winning book designed to help you get your Job 
done with the updated Interlace Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1.1. For any programmer 
using Interface Builder to design objects that truly work in 
NEXTSTEP. 

(BWIB) Our Price $24 

Using EOF 2.1 w/ OPENSTEP (Mac & Windows) 

by NeXT Software, Inc. 

Using Enterprise Objects Framework with OPENSTEP describes how 
to create an Enterprise Objects Framework applicalion on 
OPENSTEP. It includes a tutorial and a chapter on creating a user 
interface for an OPENSTEP Enterprise Objects Framework application. 
(BUEOFO) Our Price $14 

EOF Devefoper's Guide for EOF 2.1 (Mac & windows) 

by NeXT Software, inc. 

The Enterprise Objects Framework Devetoper's Guide describes how 
to develop database applications using the Enterprise Objects 
Framework tools and classes. It includes an architectural overview of 
the product, and descriptions of programming tips and techniques. 
An appendix offers a summary of Entity-Relationship Modeling. 
(BEOFDG) Our Price $24 

EOF Developer's Guide for EOF 2.0 (BEOFDG20) Our Price $24 
EOF Developer's Guide for EOF 1.x (BEOFDGIX) Our Price $24 
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Increasing Hits and 
Selling More on your 
Web Site 

by Greg Helmstetter 

Written especially for entrepreneurs, 
corporate marketing managers, small 
business owners, and consultants, this 
valuable guide gives you rare tips and 
tricks you need to know to make your 
site a commercial success. 

(BIHSMWS) Our Price $22.45 

Measuring the Impact of 
Your Web Site 

by Robert W. Buchanan and 
Charles Lukaszewski 

This book features case studies from 
many successful and some less 
successful corporate web site pioneers. 

Ybu will learn techniques and 
commercially available tools for 
measuring site traffic and visitor behavior-^nd help you choose the 
right ones for the job. Written by leading corporate site consultants this 
book tells you how to develop a management strategy geared toward 
optimizing web site productivity. 

(BMIYWS) Our Price $26.95 

The Way Computer 
Graphics Works 

by Olin Lathrop 

A complete guide to mastering 
computer graphic basics. It is written 
in a frank, down-to-earth style 
covering everything from how 
computer graphics are different from 
fine art and photographs, to modeling, 
pixels, and the principles ot animation. 

All of this is done without resorting to mind-numbing equations and 
impenetrable tectuiical jargon. 

(BWCGW) Our Price $29.65 

Debugging Macintosh 
Software 
with MacsBug 

by Konstantin Othmer and 
Jim Straus 

MacsBug, from Apple Computer, Inc., 
is the leading debugging software 
program tor the Macintosh. This 
book/disk package is an all-in-one kit 
for using MacsBug. Chapter 1 introduces MacsBug and describes 
the contents of the rest of the book. Chapter 2 describes how to 
install MacsBug and enough low level details about the Macintosh 
so that you can use MacsBug. Includes MacsBug 6.2 on disk. 
(BDMSWM) Our Price $31.45 

Web site: http://www.devdepot.com • 




AJvTiN 

I lb 


die way # 
computer 
ijgraphics 
works 






The Internet 
Strategic Plan 

by Martin A. Schulman and 
Rick Smith 

This book gives you all ot the 
management toots you need for 
creating a strong Internet and Web 
presence. A blueprint for your strategic 
plan, this book guides you every step of 
the way in establishing your company's 
place on the Internet and World Wide Web. 

(BTISP) Our Price $22.45 




The Web Navigator 

by Paul Glister 

This book keeps you right on lop of all 
the recent changes in the Web. tells 
you what's out there right now and 
what's coming in the future. Ifou'tl get 
samples ot various Internet sites and 
candid discussions of providers. You'll 
receive proven strategies for finding 
and managing information. 

(BTWN) Our Price $22.45 




JavaScript 
Cookbook 

by Yosef Cohen 

Everything you need to master the 
fundamentals of JavaScript 
programming is in this book/CD-ROM 
package. A special easy-to-use 
reference section offers detailed 
an^ysis and examples of objects, 
properties, event handlers, and 
statements. You'll also find all the latest information relevant to 
JavaScript programming since the advent of Navigator 2.0. 


(BJSCB) Our Price $44.99 


HTML Sourcebook, 3rfi 
Edition 

by Ian S. Graham 

Critics everywhere agree. HTML 
Sourcebook is the best guide to HTML 
for Web professionals. That's because 
no other book makes it so easy for you 
to quickly master all the commands, 
tools, and expert techniques you need 
to create cutting-edge Web page 
documents. Completely revised and expanded by nearly 50 percent, 
this new third edition of the best-selling guide to KTML gives you the 
complete lowdown on all the changes and enhancements to the 
HTML, HUP, and URL standards. 

{BHTMLS) Our Price $26.95 
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Designing 3D Graphics 

by Josh White 

In this powerful book/CO- 
ROM package, top 
computer graphics artist 
Josh White tells you 
everything you need to 
know to create sophisticated real-time 
3D graphics for computer games and 
virtual reality. This book contains the in- 
depth knowledge of software tools and hands-on modeling 
techniques that Josh White has learned while creating artwork for 
over 20 commercial games, including Descent, Zone Raiders, Locus. 
Legoland, and others. 

{BD3DG) Our Price $35.95 





Web Marketing 
Cookbook 

by Janice M. King, Paul Knight, and 
James M. Mason 


Create the ultimate Web 
marketing site, quickly 
and painlessly! Learn how 
to build a Web site for 
your small business or nonprofit 
organization with this step-by-step 
approach. This book/CD-ROM package contains your simple, non¬ 
technical tools for converting your print brochures, text, and graphics 
into a powerful online promotion. 


(BWMCB) Our Price $35.95 
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Developing CGI 
Applications with Perl 

by John Deep and Peter Holfelder 

A complete step-by-step guide to 
creating sophisticated interactive CGI 
applications using Perl. It you're ready 
to build your own customized 
interactive documents, forms, graphics, 
and other full-feature CGI applications 
using Perl, then this book will show you 


how. Covers CGI, HTTP, and the Perl scripting language. 
(BOCGIA) Our Price $26.95 


Rhapsody DeveloperDS Guide 

by Jesse Feller 

Covers the basic architectural principles of Rhapsody; the Mach 
microkernel, object-oriented programming, and the elements of a 
modern OS such as preemptive multitasking, protecled memory, and 
symmetric multiprocessing. Also shows ways of getting to this new 
environment—Objective C, conversion tools, and the integration of 
Java—to develop Rhapsody products. Paperback. 450 pages. 
(BRDG) Our Price $35.95 


Check out our Web site! 

• Full product descriptioRs • Hundreds of more products 

http://www.devdepot.com 


Practical Object- 
Oriented Development 
in C++ and Java 

by Cay S. Horstmann 

This book offers advice on real-world 
ways to use these powerful 
programming languages and 
techniques. Using the Unified Modeling 
Language (UML) methodology, expert 
Cay S. Horstmann gives you clear, concise explanations of object- 
oriented design. C-i-t-, and Java in a way that makes these potentially 
daunting operations more accessible than they’ve ever been before. 
(BPOOD) Our Price $31.50 


WebMaster in a Nutshell, Deluxe Editicn 

by O'Reilly & Associates, Inc. 

Cross-platform, completely portable, and lightning fast, 
bie CD-ROM is an invaluable addition to the 
webmaster's toolbox. The CD-ROM contains the Web 
Developer's Libaray—the full text of the latest editions 
of five popular O'Reilly titles: "HTML: The Definitive 
Guide, 2nd Edition"; "JavaScript: The Definitive Guide, 2nd Edition"; 
"CGI Programming on the World Wide Web"; "Programming Perl, 
2nd Edition"; and “WebMaster in a Nutshell." The Deluxe Edition 
also includes a printed copy of "WebMaster in a Nutshell." the all- 
inclusive quick reference that belongs next to every webmaster’s 
terminal. Includes CD-ROM & 356 page book. 

Requirements; The CD-ROM is readable on all platforms, but requires 
a web browser that supports l-fTML 3.2, Java, and JavaScript. 
(BWMNOTDj Our Price $62.95 
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Programming For The 
Newton Using 
Macintosh, 2nil Edition 

by Julie McKeehan and Nell Rhodes 

Tilts book gives you 
everything you need to 
create Newton 2.0 
applications. From the 
people who developed the 
Newton programming training materials tor Apple Computer, this 
book uses a dear and comprehensive approach to teach you how to 
program the Newton. Includes a CD-ROM full of sample code and 
additional goodies. The samples include solutions to all of the coding 
examples found in this book. Each example and exercise also has a 
narrafed QuickTime movie showing the solution from start to finish 
in Newton Toolkit. 

(BPFNUM2) Our Price $31.45 
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Wireless For 
The Newton 

by Julie McKeehan and Neil Rhodes 

A book that picks up where 
Programming for the Newton left off. 
teaching the reader how to develop 
Newton software on the Macintosh. The 
enclosed floppy disk provides a sample 
application, as well as a fully functional 
demonstration version of Newton Toolkit. 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment training with sample code 

• Includes disk with sample source code for a Newton application, 
as well as demonstration NTK - the complete development 
environment tor the Newton 

(BWIREL£SS) Our Price $31.45 
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JavaScript 
& Netscape Wizardry 

by Dan Shafer 

The perTect book to show you how to 
turn Netscape into your 
own personal, 
customized operating 
system. Provides the 
inside tips and 
techniques for making your Web 

pages much more attractive. Shows you how to use all of the key 
features of the JavaScript language, including objects, methods, 
properties, events, and much more. Includes CO-ROM with 
numerous interactive scripts written in JavaScript you can add to 
your Web pages today. A ramptete set of the best Java applets. 
Useful plug-ins designed to supercharge Netscape and resources to 
help JavaScript programmers. 

(BJNWIZ) Our Price $31.45 



JavaScript 1.1 
Developer’s Guide 

by Arman Danesh and Wes Tatters 

Written by developers for 
developers. An advanced 
guide to creating 
professional Web 
applications with 

JavaScript 1.1 as deployed in Netscape 
Navigator 3.0, Microsoft Internet 
Explorer 3.0, and LiveWire. Includes CD-ROM with Sun’s Java 
Developer's Kit, JavaScript and HTML Editors for Windows and 
Macintosh, 20 contributed ready-to-run JavaScripts and JavaScript 
examples from the book. 

(BJSD6) Our Price $44.99 





Web Graphics 
Tools and 
Techniques 
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Web Graphics Tools 
and Techniques 

by Peter Kentie 

The ultimate source of information on 
Web graphics for both Macintosh and 
PC users. Recent technologies covered 
include: ActiveX. Sound, Adobe Acrobat, 
Java, VRML, QuickTime VR and video. 
Shockwave, and 3D Animation. 
(BWGTT) Our Price $35.95 



Communication 

by JoAnn T. Hackos and 
Dawn M. Stevens 
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Guidelines for how 
tooplace information online 
wittiin your rampany. 

Provides both a design and 
development process and 
a set of guidelines for the Internet, 
intranets, and help systems for designers and authors who need to 
create effective electronic information. Includes CD-ROM with software 
containing tiles to help you utilize the models described in the book. 
(BSFOC) Our Price $40.45 


Standards For Online 



Linux Configuration 
& Installation, 

2nd Edition 

by Patrick Volkering, Kevin 
Reichard, and Eric F, Johnson 


Linux, the leading UNIX 
variant, has garnered 
loads of attention within 
the UNIX community. The 



■o’ 


amazing tiling about 

Linux is that you don’t need a workstation to run it. Linux 
Configuration & Installation, Second Edition lets you run Linux today. 
Program with Linux using C, C-r-r, Perl, and Tcl/Tk. The 2 CD-ROM 
pack otters one of the most popular Linux distributions, Slackware 96. 
and comes directly from Patrick Volkering, the creator of Slackware. 
(BLCI2) Our Price $35.95 
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Web Publisher’s Design 
Guide for Macintosh, 
2nd Edition 

by Mary Jo Fahey 

This is the only book that lakes you 
step-by-step through real projects 
designed by talented new media 
artists. Internet design experts share 
their design secrets and art files (took 
for art files on the companion CD-ROM 
by arlishs last name). This expanded new edition includes 
Photoshop, Illustrator and DeBabetizer tricks from the first edition 
plus countless new ways to liven up your Web pages with 3D 
graphics, sound, movies, and much more. 

(BWPDG2) Our Price $35.99 
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BASIC for the Newton 

by John Schettino and Liz O'Hara 

Program on Macintosh, Windows-based PC, or on 
the Newton itself, Straight-forward “programming by 
example" approach - you'll be writing Newton programs right away. 
Includes 3.5" disk containing Demonstration NS BASIC and over fifty 
example programs (Newton not included), 

(BNLWT] Our Price $32.35 

SEE RELATED CATEGORY: Dev. Environments 




HTML For The World 
Wide Web, 2nd Edition 

by Elizabeth Castro 

Teach yourself Hypertext Markup 
Language the quick and easy wayl This 
Visual QuickStart Guide uses pictures 
rather than lengthy explanations. You’ll 
be up and running in no time. If you 
need to team HTML fast - this is txx)k 
is for you, 

(BHTMLW2) Our Price $16.15 



Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 

The complete resource for creating 
Shockwave movies on the Web. This 
hands-on reference makes it easy to 
create Shxkwave movies and put 
them on the Web. Expert tips from the 
creators of Macromedia's first 
Shockwave movies, together with detailed examples and instruction, 
provide everything you need to get started, Includes CD-ROM. 
(BMSFD) Our Price $27 


Getting Hits-The 
Definitive Guide To 
Promoting Your Website 

by Don Sellers 

Getting Hits explains in easy-to- 
understand language the underlying 
concepts behind the art of Web site 
promotion. Just a tew of the topics 
you’ll learn include: using search 
engines with URL’s; finding related Internet groups or lists; 
understanding the nuances of click throughs and ad rates; and 
distributing press releases to key internet contacts. With this book, 
you'll go beyond the conceptual and actually follow real-world tested 
promotional campaign strategies. Bring the world to your Web site! 
(BGHITS) Our Price $17.95 



TOOL 

BDH 


Programmer’s Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials* 
by Addison-Wesley Pubiishing 

Gel quick access to reference pages for over 
4,000 Toolbox calls in your system ^ftware 
^ from their development environment. Essential 

information for Macinlosh software developers. Hypertext links allow 
programmers to view related topics easily. The ultimate elactronic 
reference tool for Macintosh programmers. 

(STBASST) Our Price $89.95 



Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembly Language 

by Gary Kacmarcik 

fake full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

(BOPTPPC) Our Price $35.96 



JavaScript For The 
World Wide Web 

by Ted Gesing and 
Jeremy Schneider 

This book takes an easy, visual 
approach to teaching JavaScript, 
where pictures guide you through the 
software and show you what to do. 
Works like a reference book, you look 
up what you need and then get straight 
to work. No long winding passages, concise, straightforward 
commentary explains what you need to know. 

(BJWVW) Our Price $16.15 
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PROGRAMMING 
FOR THE 

NEWTON 








Programming for the 
Newton Using 
Macintosh:Software 
Development with 
NewtonScript- Second 
Edition 

by Julie McKeehan & Meil Rhodes 

Praise for the Second Edition! "Rewiitten from cover to cover, this 
new edition teaches you the essentials of programming for Newton 
2.0. You must read this book. Then read it again. And again.. 
SCRIBBLES (OxNUG, Australian Newton Users Group) Includes one 
CD ROM for Macintosh 68030 or higher. 466 pp. 

(BPFNUM) Our Price $31.45 

ilKflM Leam C on The Macintosh 
Second Edition 

by Dave Mark ^ 


V-> 




TVIacin'ioi 


New revised edition! Easy-to- 
understand - everything you 
need to start programming. Updated and 
enhanced exercises that lead you step by step. 
You'll learn function, variables, point datatypes, data structures, file 
input and output and more! Includes CD-ROM with Metrowerks 
CodeWarrior’^M Lite. 

(BLEARNC2) Our Price $33.25 

SEE REtATED CATEGORY; Dev. Environments 




OBJECnVE-C 
Object-Oriented 
Programming Techniques 




by Lewis J. Pinson and Richard S. Wiener 

Presents the basic concepts of reject-oriented 
design and programming, and provides a 
precise description of the Objective-C 
language. Several small-to-medium sized applications using 
Objective-C illustrate the general principles of object-oriented 
programming. Covers the two main versions of the Objective-C 
language. Demonstrates the versatility and power of the NeXT 
machine as a platform to support object-oriented programming. 
Shows how to design, implement, and use hierarchies of classes. 
Explains the purpose of pre-defined classes and shows how they 
can be used in designing programs. 

(BOBJCOOPT) Our Price $34.15 


Check out our Web site! ^ 

• Full iwoduct descriptions • Hundreds of more products 

http://www.devdepot.com i 



Metrowerks CodeWarrior 
Programming 

by Dan Parks Sydow 



Includes CodeWarrior Lite, and Full Coverage of PowerPtant™. The 
best information on Metrowerks CodeWarrior, giving full coverage to 
the Gold Edition. CD includes Code Warrior Lite. 

(BCWPRQG) Our Price $35.95 

C++ Programming 
with CodeWarrior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Learn 
object-oriented programming techniques 
using C-t-i- as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 

(BCPPCW) Our Price $32.35 




CodeWarrior Software 
Developmentusing PowerPlant 

by Jan L. Harrington 
C-t-t programmers will learn to develop object-oriented software 
applications for the Mac and Power Mac using the PowerPlant 
environment and the classes that support it. Covers CodeWarrior 8. 
Included CD-ROM contains source code for all the programming 
examples in the book and Metrowerks CodeWarrior Lite. 
(BCWSWDEV) Our Price $31.45 




Inside PowerPlant 

by Metrowerks 

Create PoweiPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor. Full descriptions of major PowerPlant classes 
and resources. Included are the PowerPlant Constructor Manual, 
including \riew, TextTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant. 
(BINSPP) Our Price $34.95 
SEE RELATED CATEGORY; Dev. Environment 


Inside CodeWarrior Professional 

by Metrowerks 

Includes CodeWarrior IDE User's Guide. This is the printed version of the 
documentation provided on the CO. Covers CodeWarrior Professional 
Release, the debugger and associated toots. 

(BINSCWP) Our Price $34.95 

SEE RELATED CATEGORY: Dev. Environment 


AppleScript Finder Guide, English Dialect 

by Apple Computer, Inc. 

Provides definitions for Finder object classes and commands. Write, 
record, or run scripts that trigger the same desktop actions that you 
trigger using the keyboard and mouse. 

(8AFG) Our Price $17.95 

SEE RELATED CATEGORY: Scripting 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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AppleScript Language Guide 

by Apple Computer, Inc. 

A complete reference for anyone using AppleScript to modify existing scripts or to 
write new ones. Contains useful information for programmers wiio are working on 
scriplable applications or complex scripts. Features detailed definitions of 
AppleScript terminology and syntax in the following categories: Value classes, 
commands, objects and references to objects, ejgrresslons, control statements, 
handlers, and script objects. Includes many sample scripts, discusses advanced 
topics such as writing command handlers for script applications, the scope ot script 
variables and properties declared at different levels in a script, and inheritance and 
delegation among script objects. 

(BALG) Our Price $26.95 
SE RELATED CATEGORY: Scripting 


AppleScript 
Applications: 

Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Liz O’Hara 

Build complete AppleScript applications using 
FaceSpan. a user interface development tool 
that makes AppleScript applications truly 
“Mac-Like”. Itees a step-by-step approach 
to demonstrate techniques (or building 
applications through illustrations and 
samples. Provides Graphical User Interface 
(GUI) design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1.1, a demonstrations version of 
FaceSpan 2.1, source code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan. 

(BAPSCAP) Our Price ^1.45 




Special Edition 
Using CGI, 

2nd Edition 

by Jeffry Dwight, Michael Erwin 
and Robert Niles 

Iriis complete reference provides 
professional Wa developers and advanced 
personal users witfi the latest information 

on using CGI (Common Gateway Interface) to interact witti databases. 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific tips, 
fifcks, and traps 

• CO ROM is loaded with the HTML and CGI sample code from 
the book 

• Includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUCGI) Our Price $44.99 
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Java in a Nutshell, 2nd 
Edition 

by David Flanagan 

A detailed overview of alt of the new features 
in Java 1.1, both on a package-by-package 
basis and in terms of overall functionaiity. A 
comprehensive fulorial on "inner classes" 
that explains how to use all of the new types 
of inner classes: static member classes, member classes, local 
classes, and anonymous classes. Practical, real-world example 
programs that demonstrate the new leatures in Java 1.1, including 
object serializalion, the new AWT event handling model, 
internationalization, and a sample Java Bean, 

(BJNUT2) Our Price $17.95 


JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 

Allows non-programmers to take advantage 
ot the power of Netscape Navigator. Expand 
the capabilities ot your Web page, without 
having to understand C or C-f-t-. CD-ROM 
contains "Wiziets" that allows you to easily 
create your own JavaScripts. Takes you slep- 
by-step through programming cross-platform JavaScripts. Details 
how to create JavaScripts for JavaScript-aware Web browsers. 
(BJAVASCRPTJ) Our Price $40.50 
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Teach Yourself Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L. Perkins 
with Timothy Webster 


IrKvVikairi# 

Java 

MAfnWT: 


Add interactivity and multimedia to Web pages! 

A step-by-step guide to make your Website 
come aiive. Learn the basics of programming 
Java applets and the concepts behind the Java language, includes CD- 
ROM with a limited version of Roaster, the first commercial, integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 


3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 3D graphics into 
your applications. Explore Quicidraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes. CD 
contains the complete QuickDraw 3D 
system itself and a complete database of the QuickDraw 3D API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine, Book/CD-ROM, 640 pages. 

(B3D6RAP) Our Price $35.96 




liricks of The 
Mac Game 
Programming Gurus 

by McComack, Ragnemalm, Celesttn, et al. 

For beginning to expert game programmers. 
Complete overview of all the necessary 
components of game programming on the 
Macintosh, Packed with valuable tools, 
utilities, sample code, CodeWarrior' ^ Lite and game demos, 
QuickDraw 3D and Power Mac optimization and inside info on how 
Glypha III was created. Hundreds of tried-and-true tricks, tips, and 
insider secrets from well-known Mac game programming experts. 
(BTRICKS) Our Price $45 

Black Art of Macintosh 
Game Programming 

by Kevin Tieskoetter . 

Develop your own 3D games in 
C on the Mac. includes CD with 
project files for both Symantec 
C and Code Warrior. Create 
freeform texture-mapped games and 
polygon graphics. Control dynamic source 
code - all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

(BBWCK) Our Price $35.99 





Web site: http://www.devdepot.com 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devclepot.com 
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Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software's color 
capabilities with step-by-step 
insfructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
GX, Use the Pallette Manager to get the 
best colors on limited displays. Match 
colors between screens and Input/output devices {scanners & 
printers). CD Includes a complete reference information in both 
QuickView and Acrobat formats. Plus, a sample application 
demonstrating ColorSync programming techniques. 

(BADVCI) Our Price $3325 



The Internet 
Marketing Plan 

by Kim M. Bayne 
This book gives you a comprehensive 
framework for producing and executing 
a customized internet marketing plan. 
Marketing communications veteran Kim 
Bayne supplies you with a clear set of 
step-by-step procedures for 
establishing, implementing, evaluating, 
and managing your company's online 
presence. 

(BTIMP) Our Price $35.99 



Protect Your Privacy on 
the Internet 

by Bryan Pfaffenberger 

This book/CD-ROM package gives you 
proven privacy defense strategies and 
techniques to help you make the Net a 
safer place to work and play. You'll get 
the names of Inlemel privacy 
organizations that are working to 
protect your privacy rights and find out 
what you can do to help. 

(BPYP) Our Price $26.99 


Order TelMree 
800-MACDEV-1 
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Inside Macintosh: CD-ROM 

by Apple Computer, Inc. 

More than 25 volumes in electronic form. 
Includes: QuickDraw™ GX Library, Macintosh 
Human Interface Guidelines, PowerPC System 
Software, Macintosh Toolbox Essentials and More 
Macintosh Toolbox, QuickTime and QuickTime 
Components. Access over 16,000 pages of 
information with Hypertext linking and extensive 
cross referencing. 

(BIMCD) Our Price $89 



Limited time offer to buy these Inside Macintosh products - 
product descriptions please see our Web site, or feel free to 


10% off! For full 
call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

Inside Macintosh: Devices 

BIMDEV 

26.95 

Inside Macintosh: Files 

BIMFIL 

26.95 

Inside Macintosh: Imaging with QuickDraw 

BIMIMAG 

29.65 

Inside Macintosh: Interapplication Communications 

BIMIAPP 

33.25 

Inside Macintosh: Memory 

BIMMEM 

22.45 

Inside Macintosh: More Macintosh Toolbox 

BIMMAC 

31.45 

Inside Macintosh: Networking 

BIMNET 

26.95 

Inside Macintosh: Operating System Utilities 

BIMOPSU 

26.05 

Inside Macintosh: Overview 

BIMOVER 

22.45 

Inside Macintosh: PowerPC Numerics 

BIMPPCNUM 

26.05 

Inside Macintosh; PowerPC System Software 

BIMPPCSYS 

22.45 

Inside Macintosh: Processes 

BIMPROC 

20.65 

Inside Macintosh: QuickDraw GX Environ. & Utilities 

BIMGXENV 

28.75 

Inside Macintosh: QuickDraw GX Graphics 

BIMGXGR 

28.75 

Inside Macintosh: QuickDraw GX Objects 

BiMGXOBJ 

28.75 

Inside Macintosh: QuickDraw GX Printing 

BIMGXPRNT 

26.95 

Inside Macintosh: QuickDraw GX Printing Extensions 

BIMGXEXT 

26.95 

Inside Macintosh: QuickDraw GX Prog, Overview 

BIMGXOV 

22.45 

Inside Macintosh: QuickDraw GX Typography 

BIMGXTYP 

26.95 

Inside Macintosh: QuickTime 

BIMQT 

26.95 

Inside Macintosh: QuickTime Components 

BIMQTCOM 

31.45 

Inside Macintosh; Sound 

BIMSOUND 

26.95 

Inside Macintosh; Text 

BIMTEXT 

35.95 

Inside Macintosh: X-Reference 

BIMXREF 

17.95 


(Book sate prices are contingent upon availabilily) 
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For MactHtasb 
Programmers & Devehlters 



MAGAZINE 


MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with everything they neer 
know about soitware development. Topics like Rhapsody, Java. QuickTime, OPENSTEI 
Objeclive-C, C/C++, Object Oriented Technologies, product reviews and much more! 

Subscriptions; 

(MTYRDM) US/Domestic $47 for 12 issues 

(MTYRCM) Canadian $59 for 12 issues 

(MTYRFM) International $97 for 12 issues 

Back Issues; $10 each plus shipping (subject to availability) 



MacTech® CD-ROM Volumes 1-12 



• Includes Apple’s issues 1-29 (1990-1997) 

• Almost 1600 articles from all 139 issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• Improved hypertext, Improved indices, and a new THINK Reference Viewer- 
for lightning quick access! 

• New hyperlinks between articles 

• 100+ MB of source code—use them in your ^plications, with no royalties! 

• Full version of THINK Reference™ — the original online guide to Inside Macintosh, Vols. I-Vl 

• 80MB of FrameWorks/SFA archives and the most complete set of Frameworks archives known 

• Sprocket™! MacTech’s tiny framework that complies quickly and supports System 7.5 features 

• The best threads from the Macintosh programmer newsgroups plus thousands of notes, tips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

(SMTCD12) Volumes 1-12 Our Price $129 
(SMTCD12U) Upgrade from any previous version Our Price $49 


Here are more products. For full product descriptions please see our 
Th***, , Web site, or feel free to call, fax, or E-mail us. Our prices on books are at 
least 10% off list price. 



PRODUCT 

Developmeni Environments 

/^(ipifcsborts' ijuidinQ AppMcittiiais 

CODE 

. HAP'vrJU'__ 

PRfCE 

$31.45 

PRODUCT 

Madntejsh C Rogrammiiiig Rbijw .. , • 

CODE 

.ncpfliii... 

PRICE 

.24^5 

Rftfilr fnr Ihn Urwtrn P^T^r^iiTiminfj trang Mft RA5;lrt , , 

...BNFWT_. 



IVTRi^ 

.2425 

C++Pfiiyfi'inmifiQ ... . i. 

nrPHUftpy. 

. 

31.46 

MaiiinsJi Pascal Pnoipaniming PrinerVblijrna 1___ 

. msem. . 

.2425 

C+f Prografnniiifl wflp GodBWainor .. 


32^5 

Mastenog me ItiW Oass Utviry.-.... 

tMimma 

_2BJ5 

(X+-I-SDK Users .. 

.. 

„.JCPPUSfH . 

.moo 

Masnuing Itu ToullMa Usk^ THINK C .. 

_.DCPraMZ.. 

.Z42S 

CadciWairiiv kvarb f^nwiMplarl _ 

..raNRPP.. ., 

.. 34J5 

Mditiwerks CistiiiWarrici FYopfammiog ... 

_„„J*CWHft06_ 

.. 35u96 

CodeWafTloT^liwsrc Pow^opmeci Lising PowcfPlhrii .. 

...ecwswufcv. 

.j31.4.5 

Obtoctive-C - Obioct-OrtBnKJd Piogfinnminy 

..Boejotm^.. 

..34,15 



..._..54.90 

Preaijnimg WiiEpc .... 

__,„BPflEi>MAGIC_ 

..,«,^,h..152S 

,. . 

Dan Slmltx Presenfs ihe oI pfUQtapb . 

PfWffFtO 

__16.35 

Rt?;ll VWnW Afjpta fitikta.. .. . 

..JWSMMU. 

35.95 

IriSiile CrifteWafTifT _ .. ... 


_.34.flS 

;>yi[nai1lf!r; (:++ limgraritffirig . 


. 3BM 

Install CXJHBft ..... 


,,, ,,..1749 

leMgeft^ Sude kj Rngniinji___ 

___. 

tJM 

t aa tosnn ft-nffliwnmiHm riilkin .. . . 

__ 

___ n STftStT.,_ 

7A pi 

TtviPiiwei uf PmQrapftCPX.... _ . .. .. 

...BDANPHO. 

.19.95 

1 Eom 0 EXT tie Maiiotosb, 2i^ __ 

,a.EARMg? __ . 

_33.25 

fropramnvig wrtri Pnograpli CW—.... 

_ .BVigPRO. 

..30,60 

Lftam C+-i- or Hie Uanimnsfi 

.ftffIHRPP_..... 

.35 flS 

WkEtess For Htc Newlfwi... . .. 

.fiWIFltUSS. 

.3t45 
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acAfto..... 

.2&,9e 

1 n!?9Wl1bT , ,, 
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RPCKVS 

.31.46 

PowerPC Sustem ArtHWIedura . . ... .... 

. BPPCAttDi. 

31.4fi 

Internet Related 

ittw IntifHTiet White Pages.. ,,,. ,,n 

.... B&4WHrTE.. 
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_ ..SACT.IAVA__ 
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..17.96 
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45.60 
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3KdS 
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BPfBV 

.ZZ.45 
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flfUAUF 

22.45 
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...BflUlAl_ ... 

. 13.45 
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13 
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_ flpwnroni 

3&Q0 


. nwAA 

.36J30 

mtem^ TtiB Deiijxs EdHion.... 

... ... HWTDHIK . 

.3150 

bUranot Dev.. Entarpn&e te deoiServor 

..awTw.. . 

.. 44.99 

Javd Fs99itiab» hr C^&++ Pnjgummera-.. .... 

_____ EllAtfAfSSi=N_ 

17.95 

Java in a Mtrtshfiil..... 

..BJAWMlJr... 

.1345 

JfiVf) i;^lpMR^I^e ,„,,rrrr-...n 

___0JLAS._. .. 

.53.99 

.Ljwi Pingrsirnining with CfSHBA.... . 

...Eirwc^ 

..Z6.9i 

.iJIvtaSr/lpt Enr MiW'.irili'iidi .. 

...BJAVASCePT.. 

.40JQ 

L8^ KlML on tt>* Wtarinlrwh 

..... BlHrML 

. .....MM 

leafti Java on the MaotrstofirT.-.. 

....BIJAVA. 

31.45 

Miflfdmng ? D fOr h^nftp^ 

iiuA.<aun? 

.3G.60 


...BOUIMT. 

_17.95 

Mnsair Inf [hiramifs 

RUnSTHKI 

.17.99 

Mrf Chill 

nwTniAT 

. itoo 

NfltOblects Ftisitao Handnoh..., ... ._- 

^F^fFOFH..._ 

JfiLffll 

Natecape flavlgatiof 3.0....... 

... ....,BN£Tf«. 

...26.96 

Nr!(^:tifP^ NptiHr}(i(or KIS lOT M^intO^h. . .,, 

...DNFTF^SK.. 

..31.49 

PAfl flllirk Ftflfflfflrirn .,,...r..||,n,rr,ll,-rr,,,n,,,, 

......^.....BPtHJCr.-... _.. 
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are bold, book names are italicized and company names are in plain text. 
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WcbSiphon allows you to rapidly design custom 
server-side web applications by embedding 
an easy to learn, yet powerful scripting 
language directly into your HTML documents.. 
WebSiphon also includes Verona, the only 
Macintosh flat-file database server written 
spedfically for use on a web site. If you have 
ever felt restricted by other web site 
development products bn the market, then 
this is the tool for you. 


— PowerPC" Native 

- Multi-threaded 

-■ Compiled Language 
Caching 


\Aii=l-SRrlfcint=j' 


-demos - 



WebSentinel. replaces or supplements your 
web server’s built-in security, allowing more 
flexibility and power to manage users and 
secure areas, with a complete Macintosh user 
interface. Features include GREP match 
strings, custom “No Access’” tiles for each 
realm, and fiitt caching. WebSentinel’s plug¬ 
in architecture allows you to integrate with 
your e)<isting user data and security 
arehitectires. 

www.puriry.com 
1016 mopacditle. suite 101 
austin lx 78746 
phone 512.328.2288 
lax 512^28.2688^ 
infoOpuritycom 
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